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DOS/VS Serviceability Aids and Debugging Procedures 

THIS MANUA L... PR E FACE 

... is intended to guide System/370 operators and programmers using DOS/VS in 
determining and isolating the cause of a system malfunction. 

METHOD OF PRESENTATION 

Serviceability aids and how to use them are described in this manual through 
extensive use of diagrams and examples. This enables fast retrieval of information 
and largely avoids the need to use other publications in order to analyze the dumps 
and printouts discussed. 

Contents and addresses shown in the illustrations are subject to change and are 
shown only as an aid to offline debugging of DOS/VS release 29.. IBM will not be 
responsible for any system malfunction resulting from a change made by the 
user of any contents or addresses of the tables and blocks described. 

SUBJECTS COVERED 

There are four major sections; 

SECT/ON 1: Introduction , introduces the serviceability aids detailed in Section 2, 
and the debugging procedures described in Sections 3 and 4. 

SECTION 2: Serviceability Aids, describes in detail the serviceability aids, 
showing in flowchart form how to use them, and recommending when to use them. 
Examples show how to analyze dumps and printouts in conjunction with the 
debugging procedures of Section 3 and 4. 

SECTION 3: Debugging for Operators, consists of flowcharts that help the 
operator to isolate the cause of a system malfunction. The operator is instructed 
when to use the procedures of Section 2 to ensure that information is gathered 
from the system. 

SECTION 4: Debugging for programmers, this section is divided into two parts: 

Part 1 consists of checklists in flowchart form that recommend the method of 
analysis and choice of serviceability aids best suited to isolate the cause of a given 
type of system malfunction. An indication is made on the flowcharts when it is 
considered necessary to inform your IBM customer engineer when it is not 
possible to isolate the cause of an error. System information to be saved for the 
IBM CE is also listed at these points in the flowcharts. 

Part 2 is a general description of the DOS/VS supervisor/problem program interface 
tables, information blocks and save areas. It shows how to locate these areas in a 
dump, and how to analyze the data during offline program debugging. Debugging 
aids for high level languages are described in publications dealing with the specific 
language. 

PREREQUISITE KNOWLEDGE 

Operators using this manual must be familiar with the following IBM publications: 

DOS/ VS Operating Procedures GC33 - 53 78 

DOS/VS Messages GC33 - 5379 

Programmers using Section 4 must be familiar with the following IBM publications: 

IBM System/ 3 70 Principles of Operation GA 22 - 7000 

DOS/ VS System Management Guide GC33 - 53 71 

Other IBM publications referenced in this manual are listed in the bibliography at 
the back. 
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HIR Hardware Instruction Retry 
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Serviceability Aids and Debugging Procedures 



Hands-on debugging 



Detect and 
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the error. 
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Gather information 
using serviceability aids. 




Offline debugging 



Analyze the 
information. 
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Use special "tools' 
if further error 
isolation required. 
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Serviceability Aids 



Serviceability aids are "tools" offered by IBM and are designed to gather system 
information whenever a malfunction occurs on a System/370. 

A malfunction can be caused by a programming error or by a hardware failure. 

Some of the serviceability aids that gather system information when 
programming errors occur are: 

• DUMPS of specified real and virtual address areas 

• DUMPS or DISPLAYS of general registers, 

control registers, 

floating point registers, and 

program status words 

• FORMATTED PRINTOUT of the DOS/VS supervisor tables and 
information blocks 

• The ability to ALTER any register or any area of virtual storage 

• Problem determination aids, PDAIDS (event tracing routines) 

• System debugging aids, SDAIDS (program event recording and 
tracing routines) 

• Disk and tape LABEL INFORMATION display programs 

• LISTIO and MAP commands (aids that list devices used per partition, 
and that map virtual storage organization during system operation) 

• Commands that allow information contained on disk files using VSAM 
(Virtual Storage Access Method) to be printed, listed, or verified 

• Programs that display libraries and allow them to be edited and 
maintained 

• Error messages issued by the system that inform the operator about 
the nature of an error. 

The serviceability aids that detect hardware failures and produce formatted output 
concerning this failure are: 

• RMS — Recovery Management Support 

• EREP - Environmental Recording, Editing, and Printing 

• OLTEP - Online Test Executive Program 

• SEREP - Stand-alone EREP 

• Micro-program diagnostic aids, (Models 115, 125, and 158) 

In addition to the above aids, the Models 115 and 125 are provided with a micro- 
program recording facility that records certain types of hardware errors on 
DISKETTE. The errors recorded on DISKETTE can be displayed and analyzed 
by the IBM CE using the Maintenance Program Selection and Log Analysis displays. 

A similar facility is provided on the Model 158 in the form of displays obtained 
by the use of the Service function. 

A reference chart at the front of Section 2 lists the IBM serviceability aids, which 
are described in detail in that section. 

Serviceability aids offered by IBM that are designed to gather system information 

specifically for use with high-level languages (RPG II, PL/I, American National 

Standard COBOL, and FORTRAN) are not described in this manual. Details about Introduction. ■ 1 .3 

these aids are found in the corresponding manuals for the processor being used. 



What is Debugging? 



Debugging is a procedure that is followed to isolate an error (sometimes referred 
to as a bug) that prevents programs from being correctly executed by a computer 
system. 

Debugging requires the coordinated efforts of operators and programmers, and is 
divided into two distinct actions: 

• Hands-on debugging 

• Offline debugging. 

Hands-on debugging entails the examination of available symptoms and 
indications and the saving of information by the operator when a system 
malfunction occurs. 

Offline debugging requires the analysis and the isolation of an error by the 
programmer, using data gathered during hands-on debugging. 

IBM has provided special programs, commands, and procedures called service- 
ability aids, or tools, to help in gathering information about a system malfunction. 
These aids can be initialized by the operator and are of special interest when an 
error is obscure. 

The two debugging actions (hands-on and offline) can be divided into the 
following four phases as shown in figure 1.1: 

1. Determine the type of malfunction. 

2. Gather information. 

3. Analyze the information. 

4. Use aids for further error isolation if required. 
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OPERATORS 



Phase 1 



Recognize the error type: 

Unintended loop 
Wait state 
Incorrect output 
Program checks 
I/O device errors 
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Phase 2 

Gather information: 

Messages from SYS LOG 

Line printer output 

Dumps 

A MAP of virtual storage 

A LISTIO of I/O device 

assignments 

Low address storage 
System activity 
Indicator lamps 
EREP or SEREP output 
Models 115/125 Log 
analysis displays 
Model 1 58 display frames 
Loop traces 
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Program logic 



Error messages 
and Dumps 
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Figure 1-1 . The four phases of debugging 



PROGRAMMERS 



Phase 3 

Isolate the error: 

Error messages 
JCL errors 
Incorrect macros 
Linkage editor errors 
Source code errors 
Loop traces 
I/O data file errors 
Flowcharting errors 
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Phase 4 



Further error isolation: 

Trace routines 

Operator's console 

Supervisor communication 

macros 

Library and Service programs 
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System Malfunctions 



Generally speaking, a system malfunction is said to have occurred whenever a 
program did not do what it was expected to do. A system malfunction can be 
due to one or more of the following: 

• An operator error or job set (JCL) 

• An error in the program logic, a coding error, or 
the misuse of instructions 

• A hardware failure 

• An unusual circumstance during program execution. 

Because of the many circumstances in which errors may occur, system malfunctions 
manifest themselves in different ways. 

The physical size of a given system, its environment, and the type of programs used 
also play a part in how a particular error affects system operation. 
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During single-partition batch jobs (BJ) 

In this type of environment, the easiest way to recover from an error is to cancel 
the job and begin it again from the IPL procedure. However, to deal with a 
program that has been operating successfully for several hours prior to the error, 
alternative methods must be used. 

Also in this type of environment, operators "get to know" the programs and can 
recognize when the programs do not appear to be performing the same as before. 
Hands-on debugging can be performed without interfering with the execution 
of other jobs. 



Multiprogramming environment (MPS) 

To cancel, re-IPL, and restart jobs after a malfunction in this type of environment 
would delay both production and debugging procedures. Hands-on debugging is 
more difficult than with BJ, and the method used to gather information must be 
carefully chosen. It is also impossible to "get to know," by repeated use of the 
same programs, exactly what each job should be doing at any given time, and so it 
is more difficult to recognize a system malfunction. 



Teleprocessing (TP) 

Since teleprocessing is normally executed on multi-programming systems, the 
same problems are met as those described under MPS. Additionally, the 
cancellation of jobs is more difficult. The difficulty increases in proportion to the 
number of terminals online, and the number of active partitions, when the mal- 
function occurred. Hands-on debugging cannot be attempted without informing 
and affecting all the terminals. 



During program testing 

Although systems may not be large or complex in this type of environment, it is 
less likely that the operator will know the programs. In this environment, the 
testing of new programs and the simulation of space flights, aircraft structures, 
traffic controls systems, etc., are carried out daily, with unpredictable results in 
most cases. Hands-on debugging can be done only by the programmer. Even 
recognizing a system malfunction is in itself difficult. Gathering the right 
information is of paramount importance, to enable the programmer to debug 
offline. 

The previous paragraphs indicate that when a system malfunction occurs, the 
operator must be able to recognize it as such, decide on whether or not to use 
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System Malfunctions 



hands-on debugging to make a possible recovery, and decide on the best method of 
gathering information that will help the programmer. 

A description follows of the main types of system malfunctions, how to recognize 
them, and how to treat them. 
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Type of Malfunctions 

LOOPS Definition 



A loop in a program is the repetitive execution of a sequence of CPU (central 
processing unit) instructions. 

If the number of instructions in the loop is small, the loop is referred to as being 
small, short, or tight. When a loop consists of many instructions, which may also 
include input/output operations, the loop is often referred to as long. 

Types of loops 

A part of a program may be repeated a number of times, thus creating a programmed 
loop. A programmed loop is often referred to as a processing loop. Sometimes a 
program error causes the CPU to repeat part of a program endlessly. Such a loop is 
never intended and requires debugging procedures to isolate the error. 

Recognizing a loop 

One or more of the following may indicate that a job/program is in an unintended 
loop: 

• A steady glow of lights on the system Models 115, 125, and 158, control 
panel with the SYS indicator on, or for the System/370 one address will appear 
to remain displayed on the video display unit. (This depends on whether the 
loop is long or short.) 

• A rhythmic pattern in the lights on the system control panel, or for the 
Models 115, 125, and 158, the word WAIT may flicker on the video display 
unit. 

• A pointless recurrence of I/O (input/output) activity. 

• A job (program) that does not change status for a long time (for example, an 
absence of I/O activity). 

A note to the operator: When a loop is recognized, the operator must first try to 
establish whether the loop is unintended or has been programmed, before beginning 
with hands-on debugging. 

If the programmer has not warned the operator about a programmed loop, or given 
a time estimate for the program, it will be very difficult to differentiate between 
an unintended loop and a programmed loop. 

Even when time estimates are given, job or program time may increase because of 
any one or more of the following: 

• Priority of the partition in which the job is running (multiprogramming 
system) 

• CPU retry and error logging routines 

• The use of slower speed input/output units than those for which the job was 
originally planned. 

Causes of an unintended loop 



A coding or logic error in the program may cause an unintended loop. 

The operator may have set the job up incorrectly, thus causing the program 
to loop at some stage during execution. 



• An input/output device malfunction. 

• A JCL (job control language) error. 
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Operator action LOOPS 

If the operator is not sure whether the loop is unintended, the programmer must 
be contacted before any debugging procedures can begin. If this is not possible, 
the only action the operator can take is to let the job run on for a time, depending 
on system commitments, and to make notes of any further system activity. If the 
loop is programmed, no time would have been lost by allowing it to run on. In 
multiprogramming environments a loop in one partition will affect the run times 
of programs in other partitions. 

Flowcharts in Section 3 will help the operator in gathering information at the 
time the error occurs, and Section 4 provides a guide for programmers in how to 
analyze this information. 
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WAIT STATES 



Definition 

There are occasions when an error in the program or the machine causes the 
system to stop. This means that no I/O activity is occurring and no instructions 
are being executed. 

In this state the hardware circuitry turns on the WAIT indicator, or on the 
System/370 Models 1 15, 125, and 158, displays the word WAIT on the video 
display unit, and the system is said to be in a wait state. 
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Types of wait states 

The impact of a wait state on system operation depends on the cause of the wait 
and the operator action required to recover from it. The following terminology 
is used for describing a wait state: 

• Hard wait 

• Soft wait 

• Normal wait 

Essentially, the difference between the first two waits is that the system 
recovery from a hard wait is impossible without executing a system IPL, whereas 
recovery from a soft wait may be accomplished without impairing program or 
system operation. The operator can easily determine the type of wait state by 
pressing the REQUEST key. If the wait is soft the following message may be 
issued: 

AR 1I60A READY FOR COMMUNICATIONS 



When the system is waiting for operator response to a message printed on the 
console printer or for an I/O device to be made ready by operator action, 
the wait state is sometimes referred to as normal. 



Recognizing a Wait State 

Any of the following observations confirm that the System is in a wait state: 

• WAIT indicator remains on, or for a System/370 Models 1 15, 125, and 158, 
the word WAIT remains displayed on the video display unit. 

• SYS indicator remains off (See Figure 1-2). 

• No I/O device activity occurs. 

• One or more SYSTEM CHECK indicators are on. 

• A HARD MACHINE CHECK message is printed on the console printer. 

• A HARD WAIT coded message in general register 1 1 (X'B'). 

• A HARD WAIT coded message in bytes 0-3 of low address storage. 
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Causes of a soft wait 

A soft wait may be the result of an I/O operation performed on a malfunctioning 
device that is unable to complete an operation. 

A system waiting for a magnetic tape unit to rewind a tape reel or for a disk unit 
to finish a seek before continuing a program, is in a temporary soft wait. 
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WAIT STATES 



Recovery from a soft wait 

If the system is in a soft wait, it is waiting for an interrupt to signal the completion 
of an event. Although the expected interrupt may be from the timer or external 
interrupt key, a missing "device-end" caused by hardware is the most frequent 
cause. The operator can make each device not-ready, then ready, to generate a 
device-end interrupt from each device. The system light flashes briefly as the 
supervisor examines and discards interrupts for which it was not waiting. The 
interrupt from the device for which the system is waiting causes normal processing 
to continue. (The occurrence should be brought to the attention of the customer 
engineer as a possible hardware failure.) 

It may be possible to isolate the cause of the wait and take alternative action, such 
as using a different I/O device. 

Recovery from a wait state becomes more important on large online multi- 
programming systems where to cancel programs or to re-IPL may be disastrous. 
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Causes of a hard wait 

Hard waits can be caused by machine failure and programming errors. Possible 
programming errors that cause hard waits are: 

• Supervisors errors as the result of a program check while in the supervisor 
state 

• Coding errors in transient routines 

• Incorrect use of transient routines. 



Operator action 

If the hard wait has been caused by a hard machine check shown by a message on 
SYSLOG and/or a coded message in bytes 0-3 of low address storage (see note), 
the operator must gather information from the system to help the IBM customer 
engineer locate the error. 

If, however, there is no indication that the wait has been caused by a hard 
machine check, some information as to the cause of the wait can be obtained 
before retrying the job or starting a new one. 

In any case certain initial checks must be made on the setup procedures for the 
job, the input media in use, and I/O devices in use. 

Flowcharts in Section 3 will help operators in carrying out initial system checks 
and in gathering data about the wait state, and Section 4 provides a guide for 
programmers in how to analyze the data. 

Note: For the Models 115 and 125 that are not supporting MCAR/CCH, a coded 
message is placed in GR11. A complete list of coded messages is given in Section 2. 



Introduction 



1.11 



Types of Malfunctions 



INDICATORS FOR 
LOOPS AND 
WAIT STATES 



The SYS, MAN, and WAIT indicators show the CPU and 
I/O operating states as follows: 



a ns a 



Model dependent ^^/^./-vt-v-v 
control console sg)@@@ @® 
layout oh 



SYS MAN WAIT TEST LOAD 
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INDICATOR 


FUNCTION 


SYS * 


The SYSTEM indicator is on when CPU operations are 
in progress and either use meter is running. 


MAN * 


The MANUAL indicator is on when the CPU clock is 
stopped or the system is in a stop state. All pending 
interrupts are handled. Manual store/display operations 
are possible only when the MANUAL indicator is on. 


WAIT * 


The WAIT indicator is on when the system is in a wait state 
(CPU clock running but no instruction processing taking 
place). If the wait is a soft wait state and an interrupt 
occurs, the CPU is taken out of wait state and processing 
started under control of the program being executed. 



* These indicators do not exist on System/370 Models 115, 
125, and 158. Instead the corresponding words are displayed 
on the display unit. 
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CPU State 


I/O State 
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'HI/I WAIT STATE 
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'//// LOOP (with I/O activity). 



Legend 

O-off 
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Figure 1-2. System indicators. 

Aids for recognizing a loop or a wait state. 
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Definition INCORRECT 

T ♦ ♦ ♦ f ♦ ,- u ■ , OUTPUT 

Incorrect output can range from incorrect line spacing on the printed output 

from a line printer to incorrect results of calculation written on a disk file. 

Recognizing incorrect output 

Incorrect output may be detected by: 

1 . Operator 
Invalid messages 1 Ton console printer(s) 
Unidentified data >- A line printer(s) 
Duplication of data J I display unit(s) 
Lack of activity on I/O devices assigned as output units 
Either more or less I/O activity than expected. 

2. Programmer 

If the execution of a program has been apparently successful, incorrect results 
will not be detected until the data is used at some future time. 
Incorrect output can be categorized as: 

• Missing records 

• Duplicate records 

• Invalid data that has sequence errors, incorrect values, format errors, or 
meaningless information. 

Causes of incorrect output 

As well as errors in the program logic, mistakes in setting up the system for the 
program will cause errors in the output. For example, use of incorrect data for 
input files, mistakes in device assignments, and incorrect job control statements and 
commands in the job stream will cause unexpected output. 

Operator action 

If the programmer cannot be contacted, the operator must save the output (what- 
ever it is) or make a note of system activity before cancelling the job, or both. 

The work files and input data should be given to the programmer together with 
any dumps executed. It may also be necessary to re-submit the job and trace the 
logic flow by using the SDAID BR and/or IF trace. 

Flowcharts in Section 3 and 4 indicate the serviceability aid to use for isolating the 
cause of this type of system malfunction. 
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INTERMITTENT 
ERRORS 



Definition 

An error which occurs once and then seems not to recur for some time, is said 
to be intermittent. The frequency of the error may be a fraction of a second in 
the case of a high-speed computer like the System/370, or a week, a month, a year, 
or even longer. Intermittent errors can be caused by hardware failures or by 
programming errors. 



Hardware failures 

IBM provides serviceability aids that record and analyze hardware failures and 
attempt to recover from them. The routines that perform these functions are 
collectively termed RMS (Recovery Management Support). If online recovery is 
impossible, the system may be placed in a hard wait state. A message is issued to 
the system operator to run either the SEREP or EREP program. The output 
obtained from either of these programs is a listing of the statistical data accumu- 
lated up to and including the time of the error. This information serves not only as 
an aid in diagnosing machine errors, but also helps IBM customer engineers to 
increase the Reliability, Availability, and Serviceability (RAS) of the system. 

RMS does not affect system operation, except for the time required to record the 
failure and issue an informatory message on SYSLOG. 

• Note: By use of the MODE command the recording and printing of soft 
machine checks can be suppressed. (This is not applicable to the 
Models 115 and 125). 

If the retry of an error is not successful and the severity of the error prevents 
system operation, the machine attempts to issue the message 

0T1 1W HARD WAIT CODE = X (where X is an alpha character A thru I) 
and the system is placed in a hard wait state. Diagnosing this condition is described 
in Sections 2 and 3. 

On the System/370 Models 115 and 125 statistical data about the hardware is 
recorded on the DISKETTE by micro-program. The recorded data on the DISKETTE 
can be displayed on the video display unit by selecting one of the LOG ANALYSIS 
displays. This is described more fully in Section 2 — F in this manual. The 
information displayed supplements the EREP/SEREP program output that may 
also be required, depending on the type of I/O units attached to the systems. If 
a hard wait occurs with no message on the console printer, there may be a message 
in "low address storage" that will indicate an operator action. Low address 
storage and its meaning is fully discussed in Section 2. 






Intermittent programming errors 

After writing a program, it is in most cases quite impossible to test it under all 
combinations of circumstances that may occur during its use. Therefore, 
programs may contain coding errors that become evident only under particular 
circumstances, even after years of error-free use. 

Since the error does not occur every time the program is executed, and the EREP 
printout or Log Analysis display indicates no hardware failures, this type of 
system malfunction is regarded as an intermittent software error. 

Such an error can be caused by a combination of the following: 

• A change in the input data (a new card deck) 

• Poor quality input media (cards, tape, data transmission) 

• An existing coding error in a routine that is not normally executed 

• A change of routines called by the supervisor 

• The use of a new software routine 

• New operating procedures 

• Changes in the job control language. 

An error of this type is difficult to isolate, and requires the use of special 
debugging techniques. 
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Definition 

There are three types of program check interrupts: 

1. A page translation exception. This occurs when an instruction or data is not 
in the real address area. A page from the page data set must be 'paged in' to 
the real address area before the program can continue. This is not an error 
condition. 

2. Program check interrupt resulting from the use of the MC (monitor call) 
instruction. This is not an error condition. 

3. Program check interrupt resulting from incorrect specification or use of an 
instruction or data by the problem program. This is an error condition, and is 
always reported by a message issued on SYSLOG at the time of the program 
check as shown below: 
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PROGRAM CHECK 
INTERRUPT 



BG 0S03I PROGRAM CHECK INTERRUPTION - HEX LOCATION 0406E0 - 
CONDITION CODE 3- DATA EXCEPTION 
0S00I JOB DEBUGEXS CANCELED 

The program is automatically cancelled by the supervisor and depending on the 
use of the job control statement / / OPTION DUMP, or the DUMP option being 
supported by the supervisor, a dump of the supervisor and of the partition owning 
the program is executed. This automatic program cancellation is termed abnormal 
EOJ (end of job), or program abnormal end. The program check message gives 
the location of the failing operation and the condition code. This gives the pro- 
grammer a starting point for offline program debugging. 



Causes of a program check 

The most probable cause is improper specification or incorrect use of instructions 
or data in the program. 

Program checks occur most frequently during program testing, because of 
incorrect coding or errors in the program logic. 

Operator action 

No action can be taken by the operator other than saving for the programmer the 
console printer log sheet, the dump (if executed), job stream, and any input 
data files used by the failing program. Flowcharts in Section 4 will help the 
programmer to analyze the information and isolate the error. 
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I/O DEVICE 
MALFUNCTIONS 



A device malfunction either will be seen immediately as an incorrect physical 
operation, or will cause the system to enter a wait state, loop, or produce 
incorrect output as already discussed. Normally an error message will be 
issued on SYSLOG. 



Examples of device malfunctions 

Some obvious device malfunctions are: 

• Mechanical noises not normally present 

• Lamps either on or off which the operator recognizes as not normal conditions 

• A lack of movement of input/output media which the operator knows to be 
incorrect at the time 

• "Tape Runaway," a special type of error that occurs on magnetic tape drive unit 
(A mounted tape winds forwards at a higher speed than normal.) 

• Incorrect "form skipping" on the line printer. 



Operator action 

If there is no obvious action that can be taken such as pressing the device STOP 
and/or OFF buttons, consult the device component manual before informing 
your IBM customer engineer (unless the nature of the malfunction constitutes 
a danger to human lives and equipment). 
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Gathering Information 



When a system malfunction is recognized it is important that the operator obtain 
information from the system. The information helps the programmer and the IBM 
customer engineer during offline program debugging. Whatever the system mal- 
function, the operator must always save error messages issued on SYSLOG and/or 
on SYSLST, and in some cases save the I/O media (card files). 

The operator can obtain information by doing one or more of the following: 

• Issue the MAP command. 

• Make a note of system activity. 

• Display low address storage, the current PSW, the control registers and 
general registers. 

• Execute a storage dump. 

• Take a trace of a loop. 

• On the Models 135, 145, 155-1 1, and 158, initiate the EREP or SEREP 
: programs 

• On the Models 1 15 and 125 on the advice of the IBM CE use the Log 
Analysis to display hardware errors recorded on the DISKETTE, 
and on the Model 158 use the display frames. 

Many factors must be considered when gathering information, and Section 3 and 4 
cover this subject in detail. 
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Gathering Information 



LOW ADDRESS 
STORAGE 



This area of low real storage (as defined in the Introduction to DOS/VS) is one of 
the important sources of system information used to aid offline program debugging. 
The contents of the low address storage can be dumped (printed out) or displayed 
by using job control commands or console aids. Details about the format and 
contents of the low address storage are given in Section 2-E of this manual. 
Figure 1-3 illustrates the location of low address storage in relation to other areas 
in virtual storage. 



Wait state messages 
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CAW 

CSW 

Timer 
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Partitions 

for user programs 
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LOW ADDRESS STORAGE 



SUPERVISOR 



PROGRAM A 



PROGRAM B 



PROGRAM C 



PROGRAM D 



PROGRAM E 
HIGH ADDRESS STORAGE 






Figure 1-3. Relative location of low address storage. 

Low address storage contains information to aid offline debugging 
(Size relationships in this figure are purely illustrative.) 
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A dump is a program or an operation that prints the image, in hexadecimal format, 
of a selected area of virtual storage. This term is also used when an area of virtual 
J storage is recorded or stored on magnetic tape or on a disk pack 

Figure 1 -4 illustrates the various type of dumps offered by IBM. Section 2- A of 
this manual describes how to execute the dump programs and operations, and 
discusses the meaning of dump output that is useful during offline program 
. debugging. 
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A dump or display of the 
low address storage. 

Attention routine commands 
and operator's console. 



A dump of a partition in the 
real or virtual address area. 
This is referred to as a 
Partition dump or a System 
dump and includes a dump of 
the supervisor area. 
System generation option, 
job control statement, job 
control command, and 
assembly macros. 



A snap shot dump used to 

display small parts of a 

program at any selected 

area. 

Attention routine commands and 

assembly language macros. 



A dump of the SVA 

Partition dump or a System 
dump includes a dump of 
the SVA (or part of it) if 
a program check occurs 
in the SVA. 



Figure 1-4. Storage dumps. 

Various areas of storage can be dumped or displayed using the IBM dump 
programs and console aids. 

(The dividing point between real and virtual address areas depends on the size 
of the hardware memory on your System/370). 
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Gathering Information 

LOOP TRACING 



Three methods of tracing or recording the path of a loop are provided on the 
System/370: 

1 . By using the facilities provided by the operator's console, the operator can 
list the addresses of the instructions used by the loop. 

2. By using the successful branch routine of the SDAIDS. 

3. By using the instruction fetch trace of the SDAIDS. 

All three methods are described in Section 2. The first method is useful to trace 
small loops during hands-on debugging. However, the amount of time that may be 
spent tracing a loop by this method depends on the answer to the following: 

1. How important is it to system operation that the loop be fully traced? 

2. How will the time spent tracing the loop affect system commitments? 
Normally the operator is not in a position to answer these questions and if the 
programmer or the DP manager is not available, he can only take a short trace. 
The second and third methods can be used either during hands-on debugging, or 
during re-runs of the program generating the loop. 






A note to operators 

Before tracing a loop by using any of the above methods, you must consider their 
effects on time-dependent programs currently running in the system. Such 
programs are, for example, those using magnetic ink character recognition or 
teleprocessing equipment as input/output devices. 

Guidelines on how to isolate an unintended loop and trace it are given in 
flowcharts in Sections 2 and 3. 
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RMS (Recovery Management Support) HARDWARE ERROR 

RECORDING AND 

The functions employed in recording a hardware error and recovering from it are RECOVE R Y 

collectively termed RMS (Recovery Management Support). RMS was introduced 
under "Hardware failures" in this Section. RMS software routines record hardware 
failures on the system recorder file, located on SYSREC (SYSREC can be either 
an area on SYSRES, or an individual disk pack.) 

For the System/370 Models 1 15 and 125, errors in the CPU and natively attached 
input/output devices (except tape units and teleprocessing terminals), are recorded 
on the DISKETTE. Recording is performed by microprograms and is independent of 
the RMS software routines. 

Figure 1-5 contains an overview of RMS, which is a part of the total RAS 
(Reliability, Availability, and Serviceability) concept. RMS uses a monitor and 
several transient routines that check the severity of the error, record it (if possible), 
and print informatory messages. 

Using an IBM program called EREP (Environmental Recording, Editing, and 
Printing) the data on the recorder file can be printed on a line printer. This data 
is used to investigate the nature and cause of a system malfunction. For the 
Models 115 and 125, information will be printed by EREP only if the system 
supports RMS. (Refer to Section 2-F for details.) 

If the severity of a hardware error is such that EREP can not be executed, the IBM- 
supplied program SEREP must be executed. SEREP is a stand-alone version of 
EREP that formats and prints the data held in the logout areas of real storage. 

On the System/370 Models 1 15 and 125, the LOG ANALYSIS displays hardware 
statistical data recorded on the DISKETTE. This is additional to the EREP program 
that can be executed after using the log analysis displays. 

A similar facility is provided on the Model 158 in the form display frames obtained 
by the use of the SERVICE function. 

How to execute EREP and SEREP, and how to use the log analysis displays and 
display frames feature is described in Section 2. The components of RMS are fully 
described in Section 2-F. 
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Hardware error 



Error detection, correction, and 
recovery by hardware microprogram 



Machine check interrupt 
generated for CPU error, 
main storage and control 
storage errors. 



I/O interrupt generated 
for I/O channel and device 
errors. 




For System/370, Model 1 15/125 
record error on DISKETTE and 
SYSREC. For Models 135, 145, 
1 55-1 1 , and 1 58, log error in 
the LOGOUT areas of real storage. 



Automatic System Action 
(depends on severity of error) 




Saves data about the error 

in registers 

Continues processing in a 

degraded mode 

On Models 115/125/158 

recording on DISKETTE 

occurs 



Automatic system action 



RMS 
Software A 
Routines 



Re-analyze 
data about 
the error. 



Tries to record data about the 
error on the system recorder. 



Tries to print a message on 
SYSLOG to inform operator 
about the type of error. 
Places system in a hard wait. 



Automatic system action 




Records data about the error 
on the system recorder file. 



Cancels the job in which 

the error occurred. 

Prints a message on SYSLOG 

to inform the operator of 

system action. 

Continues processing with 

next job. 



Automatic system action 



Records data about the 
error on the system 
recorder file. 



• Prints a message on SYSLOG 
to inform operator that a 
hardware error has occurred. 

• Continues normal processing. 



Operator action 



For use by IBM 
customer engineers 
during scheduled 
maintenance 



For System/370, Models 1 15 and 
125, use the LOG ANALYSIS 
feature to display hardware 
statistical data and for Model 158 
use the display frames 



Figure 1-5. An overview of RMS. 

This illustration shows the general connection 
between the hardware and software components of 
hardware error recording and recovery functions. It 
also shows the connection between RMS and the 
EREP and LOG ANALYSIS programs. 



f 



Use EREP to print out 
the data about hardware 
errors recorded on the 
system recorder file. 



the 



Programmer action 



} 



IBM customer engineer's action 



Use the EREP printout to 
find out more about the 
system. 



Use EREP printouts to aid 
in hardware error diagnosis. 
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EREP (Environmental Recording, Editing, and Printing) HARDWARE ERROR 

RECORDING AND 
This program edits and prints information about hardware failures that are RECO VE R Y 

recorded on the system recorder file (SYSREC). 

There are several options of EREP that enable the operator to select SYSREC 
records for editing and printing. These options are detailed in Section 2. By using 
the EREP program output, the IBM customer engineer can recognize hardware 
failures. During scheduled maintenance periods he can then perform preventive 
maintenance on the parts of the system causing hardware failures. 

Because the EREP program can be initiated by the operator, it is a useful aid for 
gathering data about the condition of the hardware at any time during 
system operation. 

Some messages issued on SYSLOG tell the operator when to execute EREP. 
For example: 

0T1 1W HARD WAIT CODE = D 

RUN EREP RECORDING SUCCESSFUL 

Other occasions when EREP should be executed are indicated in DOS/ VS 

Messages. 

For example: 

0T05E ERROR ON RECORDER FILE - RUN EREP 
Operator action: 
Schedule the EREP program to display the information on SYSREC. 

Either the operator action listed under the appropriate message will indicate 
the EREP option to select, or your IBM customer engineer will advise you on the 
option to select. 

Flowcharts in Sections 3 and 4 also indicate when to execute EREP. 
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SEREP (Stand-alone EREP) 

This is a stand-alone program that edits and prints hardware failure data either 
stored in the logout area of real storage or, for the Model 158, recorded on the log 
recording console file. 

SEREP provides a means of printing system status information stored in the real 
storage logout areas at the time of the machine malfunction. The SEREP 
printout is analyzed by your IBM customer engineer. 

For the Models 135, 145, and 155-1 1, SEREP is initiated using the standard IPL 
procedure. The SEREP program consists of a card deck and must be executed 
when the message issued on SYSLOG indicates "RUN SEREP." 
For example: 

0T1 1W HARD WAIT CODE = H 

RUN SEREP RECORDING UNSUCCESSFUL 

For the model 158 SEREP is contained on the Log Recording Console File which 
is loaded by using the Service and Index frames. 

If a hard wait condition occurs and no message is printed, a wait message in low 
address storage will inform the operator if SEREP is to be initiated. 

Flowcharts in Sections 2 and 3 indicate how and when to use SEREP. 
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Log Analysis Displays (Models 115 and 125) 

This aid, provided for IBM CE use, enables the condition of the internal hardware 
to be displayed, and, if required for offline analysis, to be printed on the 5213 
printer, if attached. On advice from the CE, an operator is able to obtain "hard 
copies" of the displays if a hardware error is the cause of a system malfunction. 

Maintenance (M) 

When the mode selection display is on the video screen and the operator enters 

selector character 'M' against 'Mode Specification,' the screen displays the 

maintenance repertoire. This repertoire consists of log analysis, micro tests, and 

CE manual operations, as shown in the figure below. The cursor is positioned next 

to the preselected 'M' so that any one of the maintenance modes can be 

selected. 
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* MAINTENANCE PROGRAM SELECTION 



LU 


G 


TE 


STS 


CE 


-MAN.CPS 


A = 


= LOG GENERAL 


J = 


= CPU 


S = 


I OP 


B = 


= CPU 


K = 


= 1403 


U = 


CRT-SCOPE 


c = 


= CARD/PRINT I/O 


L = 


= 2560/5425 


V = 


l/OEXERS 


D = 


= DISK 


M = 


= 3504/3525 


X = 


IPU 


E = 


= ICA 


N = 


= DISK 


Y = 


MATRIX S 


1 = 


= CHANG. DISKETTE 


= 


= ICA 


Z = 


MATRIX M 



PROGRAM SELECTION: M R = SYSTEM TEST (ASCP) 




o oo QQ a C OD r 

DOQQQOaO 



Note: E = ICA is displayed only when the system supports the Integrated 
Communications Adapter 

Figure 1-6. Model 125 maintenance program selection display. 

On the Model 115 the entry M = 3540/3525 and entry K = 3203/5203 

Log Analysis (A-E) 

When a parameter 'A' through 'E' is entered into the maintenance display, log 
information is brought to the screen. Entering 'A' for instance, causes a display of 
general log information that informs the operator if any logging occurred, and if 
so, which part of the system caused it. From this report, the operator can select 
a detailed log by keying in one of the four characters 'B' through 'E\ For example, 
'B' provides log information for the CPU. 

A "hard copy" printout of the displayed information can be obtained and saved 
for your IBM customer engineer by pressing the copy key, if a 5213 matrix printer 
is attached to your system. 

Further details are given in Section 2, F-5. 
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Display Frames (Model 158 only) 

A serviceability aid provided on the Model 158 allows the operator to display and 
obtain "hard copies" (on the 3213 printer) of the condition of the hardware. 

The information displayed or printed is used by the IBM CE to diagnose the cause 
of a permanent hardware error. A hardware error of this type will be recognised 
by the operator by an error message displayed on the program frame, for example 
the words STOR CHECK displayed in the lower right corner of the frames. 

Having recognized the existence of a hardware error, the operator can either inform 
the IBM CE immediately, or can "look at the hardware" by scanning the information 
on the display frames and obtaining a "hard copy" of them if desired. 

The type of information displayed is listed under numbers 6 to 26 in the INDEX 
frame shown below. 



21-CPU CHECKS&RETRY 



3-CONFIGURATION 



23-CHANNEL CHECKS1 
24-CHANIMEL CHECKS2 



7-CTRL STORE DISPLAY 
8-COMMON CH DISPLAY 
9-CHANIMEL DISPLAY 
10-CHANNEL 1 DISPLAY 
11-CHANNEL 2 DISPLAY 
12-CHANNEL 3 DISPLAY 
13-CHANNEL 4 DISPLAY 
14-CHANNEL 5 DISPLAY 
15-SCUDATA FLOW1 
16-SCU DATA FLOW2 
17-CHANIMEL TO CHANNEL 
18-EXECUTION ARRAY 



20-CSBAR BKUPS 



28-EXTERNAL DIAGNOSTICS 



/On 



COMPOSE- "START "STOP "CLEAR 



Figure 1-7. The Model 158 Index Frame 

This frame is obtained via the manual and service frames. With this additional information 
about the hardware, the IBM CE will be able to advise on further system operation. 
How to use this serviceability aid is described in Section 2-F. 
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If the error cannot be isolated by analyzing the information obtained from the 
procedures already mentioned, other programs and tools must be employed during 
program reruns. 



Trace routines 

The trace routines supplied by IBM are special programs that "look inside" the 
central processing unit during system operation. 

Traces of program execution are especially valuable on the larger multiprogramming 
systems. 

Traces can indicate the phases used, the supervisor calls required, the types of 
interrupts encountered, and the I/O activity during program execution. Trace 
routines can also indicate paging activity and successful branching, and produce a 
printout of instructions fetched, and storage and general register alterations, 
during program execution. 



Supervisor communication macros 

Certain DOS/VS macros can be written into programs to provide more information 
about the state of the system at the time of an error. One such macro is PDUMP, 
which will give a dump of any specified real or virtual address area. 



Operator's console 

A useful tool for hands-on debugging is the operator's console. This is used for 
"tracing a loop" and displaying or altering registers and small areas of storage. 



Library and Service programs 

DOS/VS library and service programs are useful when information is required 
about previously written programs that are used by problem programs. These 
DOS/VS programs will list volume directories, print listings of the programs 
contained in the libraries, and display file label information. Such information 
is required, for instance if a particular phase on a private core image library causes 
incorrect results of calculations when used by one of the tested problem programs. 



VSAM Programming Aids 

VSAM (Virtual Storage Access Method) provides aids that print, list, and 
verify data recorded on VSAM files. Assembler macro instructions for VSAM 
are also provided to allow the programmer to obtain information about I/O 
operations (OPEN, GET, PUT, CLOSE) during execution of VSAM programs. 
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The analysis to be made depends on when the job failed and how much pertinent 
information the operator obtained from the system at the time of failure. It also 
depends a great deal on the system environment. The first step is to examine 
messages printed on the console log sheet, and to look for any messages on the 
output printer. 

The next step is to examine any other printed output, for instance, program output 
and storage dumps. 

For a successful analysis, the programmer, who should be familiar with the 
program, will require: 

• The program listings 

• The linkage editor map 

• Flowcharts of the failing program. 

In the more difficult cases of program errors, the programmer will also require: 

• The supervisor listing 

• Output of the trace routines 

• Dumps of the data input files 

• The input media 

• Listings (or displays) of file label information 

• Listings (or displays) of the libraries. 

If the program failure was caused by a hard wait, the programmer should scan the 
EREP printout (if one was obtained) to eliminate any possibility of a hardware 
failure, and examine the stand-alone dump. 

Section 4 describes in detail how to use the above listed output during offline 
debugging. 
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Section 2 

SERVICEABILITY AIDS 



How to use this section. 

Familiarize yourself with the contents of this section, which gives details about 
the operation and execution of the serviceability aids offered by IBM. 

The reference chart shown on the opposite page lists the aids described in this 
section in groups according to type. 

All right-hand pages in this section have running-tabs numbered to correspond to 
this chart. The chart helps you to locate details about any aid described in this 
section. 

For example: 

SEREP is described on page marked F — 4 

Another example: 

When a dump of the low address storage is required in an operators flowchart of 

Section 2 and 3 it is indicated as: 



Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 



See D-1 -F for Models 1 35, 145, 1 55-1 1 
and D-2-F for Models 1 1 5, 1 25 
and D-3-Ffor Model 158 



D-I-F, D-2-F and D-3-F refer to tab numbers that identify unique pages in this 
section. 

In this example it guides the operator to the flowchart procedure for dumping 
low address storage. 



Table referencing in this Section 

Illustrations in this Section do not have figure numbers, but are referenced by the 

text. For example, "the next illustration shows " or "the figure on the 

opposite page shows the ". 

However, because tables in this section are often referenced from other parts 
of this manual the tab referencing system is used for the Tables. For example: 
A table in sub-section B-6 is given the reference of B-6. If there is more than 
one table in any sub -section the first table is given the reference B-6-A and the 
second table B-6-B, and so on. 
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program 
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ALTER/DISPLAY 
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stepping 
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and 155-11 



Instruction 
stepping 
Models 115 and 
125 

Instruction 
stepping 
Model 158 



Stop on address 
Models 135, 145 
and 155-11 

Stop on address 
Models 115 and 
125 



Stop on address 
Model 1 58 

Models 115 and 125 
Console dump 
operation 

Store status and 
clear real storage 
(ail Models), and 
Save Usage Counters 
(Models 115 and 125 
only) 



Job control 
commands and 
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Low address 
storage 
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messages 



Linkage Editor 
Map 



Hardware error 
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Support 
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Support 
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EREP 
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Display frames 
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Dumps of, and changes to Real and Virtual Address Areas 



OPERATOR COMMANDS 
(ALTER) 



The ALTER Command 

To activate the ALTER command press the REQUEST key and enter ALTER. The 
command is used to alter from 1 to 16 bytes of virtual storage starting at the 
specified address. 



G 



Operation 


Operand 


ALTER 


xxxxxx 



The operand xxxxxx is a six-digit hexadecimal address. Six digits must be 
entered regardless of the size of the address; addresses of less than six digits must 
be preceded by zeros. 

After the command has been entered and the END key pressed, the hexadecimal 
representation of the information to be placed in storage should be entered. Two 
hexadecimal characters (0 to F) must be entered for each byte to be changed. 
If an odd number of characters is entered, the last character is ignored and its 
associated byte is unaltered. 

Examples are shown below. 

















• 


AR 


I I60A READY FOR COMMUNICATIONS. 








AR 


alter 040820 










AR 


00622000 








• 


AR 


alter 000430 








AR 


J. 1420 ADDRESS WITHIN SUPERVISOR OR SVA 










AR 










• 


AR 


1IA0A READY FOR COMMUNICATIONS. 








AR 


alter 0404 eO 










AR 


8a 800004 








• 


AR 




fxIKT 




















^twi^ 
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Restrictions 



1. If the bytes to be altered cross the boundary from a valid to an invalid address 
space (see the third restriction, below), only the bytes in the valid address 
space are changed, and the following message is issued on SYSLOG: 

11471 XX BYTES COULD ONLY BE ALTERED 



OPERATOR COMMANDS 
(ALTER) 






2. If the highest available virtual storage address is exceeded before sixteen 
bytes are printed, the command is terminated and no alteration can occur. 



3. If the specified address is within an invalid address space, message 

1I41D INVALID ADDRESS 

is issued on SYSLOG. 

An INVALID ADDRESS is one of the following: 

• The address of a location in the gap between real and virtual 
address areas. 

• The address of a location beyond the end of virtual storage. 

• The address of a location in the page pool. 

• The address of a location in a virtual partition whose real partition 
contains a program running in real mode. 

4. Altering the Supervisor area or SVA 

If the address entered falls within the supervisor area or within the shared virtual 
area (SVA), a warning message is issued on SYSLOG: 

1I42D ADDRESS WITHIN SUPERVISOR OR SVA 

To respond to this message, press END/ENTER to terminate the ALTER 
command or reply with IGNORE to allow alteration. 

When to use 

This aid is primarily a hands-on debugging aid. The programmer can use it in 
conjunction with program listings to modify any part of the programs presently 
running in virtual storage. This enables immediate checks on results of 
program changes during execution of the program. 
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The DISPLAY Command 

To activate the DSPLY command press the REQUEST key and enter DSPLY. The 
command allows the operator to display on the console printer keyboard 16 bytes 
of virtual storage starting at the specified hexadecimal address. Two hexadecimal 
characters (0 to F) are printed for each byte of information; these characters 
represent the hexadecimal equivalent of the current information in the virtual 
storage. 



Operation 


Operand 


DSPLY 


xxxxxx 



The operand xxxxxx is a six-digit hexadecimal address. Six digits must be 
entered regardless of the size of the address; addresses of less than six digits must 
be preceded by zeros. 

After the command is entered and the END/ENTER key is pressed, the hexadecimal 
representation (two characters for each byte) of sixteen bytes of virtual storage 
will be printed. 

Examples are shown below. 




V> 



2.8 Serviceability Aids. 



^**v 



Dumps of, and changes to Real and Virtual Address Areas 



-\ 



^y 



Restrictions 



1. If the sixteen bytes cross the boundary from a valid to an invalid address space 
(see the third restriction, below) only the bytes in the valid address space are 
displayed, and the following message is issued on SYSLOG: 

11481 XXBYTESCOULDONLYBE DISPLAYED 

2. If the highest available virtual storage address is exceeded before sixteen bytes 
are printed, the command is terminated. However, the contents of those 
bytes that fall within the virtual address area are printed. 

3. If the specified address is within an invalid address space the following message 
is issued on SYSLOG: 

1I41D INVALID ADDRESS 

The definition of invalid address space is listed under item three of "Restrictions" 
in the description of the ALTER command. 

When to use 

This aid can be used during hands-on debugging, or an operator can be 
instructed to use it at specific addresses in a program. 

For instance, loop count areas, small areas modified by loops, or parts of I/O 
areas can be dumped or displayed during program execution. The dump 
information will help during offline program debugging. 
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The DUMP Command 

To activate the DUMP command press the REQUEST key and enter DUMP. The 

command allows the operator to display large areas of virtual storage on SYSLST. 

The SYSLST used may be assigned to any partition, but it must be a printer and it 

should not be in use by the partition. If the same printer is being used by the 

partition, the printed output will be a mixture of dump and partition output. 

If SYSLIST is assigned to a 32 1 1 printer and the printer's indexing feature 

is being used, a certain number of characters may get lost on each line of 

the dump. To avoid this, the operator should load a new FCB (forms control buffer) 

image to disable the indexing feature before he issues the DUMP command. 

The new FCB image can be loaded either by issuing an LFCB command 

or by executing the SYSBUFLD program. 






Operation 


Operand 




_, 


—I 


DUMP 




S 
BG 


(BG) 
(Fna') 


* Note 1 






Fn 








BGS 








FnS 








PDAREA 








xxxxxx, xxxxxx 













n,n' = 1,2,3,4 



Note: 



If the first operand is omitted, the general registers, control registers, and all 
storage that is currently used by programs, except that used by the supervisor 
(unless the operand BGS or FnS is specified), will be dumped. See note 2. The 
storage used consists of: 

1. Real storage not belonging to the page-pool 

2. The virtual partitions in which a program is currently running. 






Description of the operands: 



Operand 


Meaning 


S 


Causes a dump of storage used and the supervisor area. See note 2 


["] 


Causes a dump of the specified partition and its associated registers. 
If a real-mode program is running in the specified partition, the temporary 
real partition is dumped. If a virtual-mode program is executed in the 
specified partition, the whole virtual partition is dumped. 




~BGS| 
_Fn S J 


Causes a dump of the same areas as described for the BG/Fn operand. 
However, the dump will include the supervisor area. 


PDAREA 


The PD area and the registers will be dumped (See Section 2, B-3 for 
details and a description of the PD area.) 


XXXXXX, 
XXXXXX 


Specifies the starting and ending address of virtual storage, with 
associated registers, that is to be printed. If the starting address is not on 
a f ullword boundary, the address is rounded down to the first fullword 
boundary; if the ending address is not on a fullword boundary, the 
address is rounded up to the first fullword boundary. A minimum of one 
fullword is dumped, beginning at the start address. 



Note 1: 



BG 
F1 
F2 
F3 
F4 



>•< 



When any of these additional operands are specified, the area of virtual storage 
specified by the first operand is dumped on the SYSLST assigned to the partition 
specified by this operand. SYSLST must be a printer and should not be in use by its 
assigned partition. If the same printer is being used by the partition, the printed output 
will be a mixture of dump and partition output. 
v (If this operand is not specified, the SYSLST printer assigned to BG is used. See note 2.) 






2.10 Serviceability Aids. 



Dumps of, and changes to Real and Virtual Address Areas 



When to use 



o 



This command is useful in circumstances similar to those described for the 
DSPLY command: to obtain information about I/O areas, or areas modified by 
loops or transients during program execution. The only difference between this 
command and DSPLY is in the size of the area that can be dumped. 

Note: Logical transient routines can not be checked because the LTA is used by 
the DUMP transient. The information in the LTA is therefore overwritten by 
the DUMP rou tine. 

An example is shown below of a dump of the PD area using the DUMP command, 
when SYSLST is assigned to a line printer. 



OPERATOR COMMANDS 
(DUMP) 







a 


CR 0-7 
) C* 8-F 

POARFA 

' 009*80 
009440 

| O094C0 
009*60 
009 500 

| 009 520 

* 009 540 
009 560 

k 039580 
' 0095A0 

0095CO 
| 0095EO 
' 009600 

009620 
| 009640 
' 009660 

009680 
| 0096AO 
' 009 6C0 

0096E0 
| 009700 
' 009720 

009740 
| 009760 
' 009780 

009 7A0 
| 009 7C0 

* 009 7E0 
009800 

| 009820 

' 009 840 

009860 

| 009880 

* 0098AO 
009 SCO 

| 0098E0 

' 009900 

009920 

| 009940 

* 009 960 
009980 

| 0099A0 

' 009 9C0 

0099E0 


804000EO 
OOOO5 300 

E3D37EF3 
00003000 
FFFFFFFF 
FFFFF=80 
50C091C4 
47F09384 
00004111 
58B10020 
600347=0 
078A070A 
078A3501 
91B807=A 
0O1842A3 
47F09110 
00009666 
8AF33300 
8AF00000 
20000000 
00OE070C 
04000000 
00008A : 
FF008AFO 
070=2000 
OOO0O00E 
00000400 
09620000 
OOOEFFOO 
OOO6O70F 
04000000 
00000000 
00000962 
O0O0000E 
OOOOOOOE 
00000400 
09620000 
20000000 
E2400000 
08003000 
00000000 
00000962 

070:2000 

00005240 
8AF00800 
8AF0O0OO 


OOOOF60O 
00000000 

F8F07000 
00004798 
FFFFFFFF 
800047AE 
58A00014 
95FFA002 
000058CO 
19AB4740 
910CBFB7 
49209038 
B00691C8 
58B09188 
00029430 
58A1001: 
000099FC 
OOOOOOOE 
00000400 
09620000 
20000000 
E 2400000 
08000000 
00000000 
00000962 
070C2000 
0000E240 
8AF 00800 
8AF 00000 
20000000 
0OOE070C 
04000000 
00008AF0 
FF008AFO 
070F2000 
OOOOOOOE 
00000400 
09620000 
OOOEFFOO 
000E070F 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
00000400 


FFFFFFFF 
00000000 

000099FF 
O0OO3AA4 
FFFFFFFF 
47F0915C 
48A0A040 
47B3910C 
91C49120 
90FE41C8 
B0454770 
O78A070A 
076A58B0 
44009068 
B002912 
50AB0005 
C4E4D400 
070F2000 
OOOOOOOE 
000004 00 
09620000 
OOOEFFOO 
000E070F 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
000004 00 
09620000 
20000000 
E2400000 
08000000 
00000000 
0000096 2 
070C2000 
0000E240 
8AF00800 
8AF00000 
20000000 
OOOE070C 
04000000 
00008AFO 
FF008AFO 
070F2000 
OOOOOOOE 


FFFFFFFF 
00030300 

0000479C 
00031330 
3FDEFFFF 
58B091B8 
492AOOO0 
1BCC43CA 
100647EO 
004819AC 
90D:D7D2 
4920903A 
91B841BB 
502B0302 
10064710 
9133B332 
30002330 
30300962 
070C2000 
3000E240 
8AFOO80O 
8AF30300 
20000300 
000E070C 
04000000 
00008AFO 
FF008AFO 
070F2000 
OOOOOOOE 
00000400 
09620330 
OOOEFFOO 
OO0E070F 
04000000 
00000000 
00000962 
OOOOOOOE 
0OO3030E 
00000400 
09620000 
20000300 
E2400000 
08000300 
00000300 
00000962 
070C2000 


00000000 
00300000 

0O3O153E 

07:4ci:9 

FFFFFFFF 
020FB002 
4780909C 
033239:0 
910C50C0 
472090FE 
B33BB33B 
078A58B0 
001259B0 
501B0036 
919C9130 
47809192 
D5E7FFFF 
30300030 
00000962 
0000003E 
0D00003E 
00300400 
09620000 
20000000 
E2400030 
08000 000 
00000030 
00000952 
070C2030 
0000E240 
8AF00800 
8AF00000 
20303000 
000E070C 
04000000 
30008AF0 
FF008AF0 
070F2030 
OOOOOOOE 
00000400 
09520000 
300EFF3O 
000E070F 
04303000 
00000000 
00000962 


00000000 
00000000 

0000B44E 
C4C9E3E6 
FFFFFFFF 
00380201 
95FFA000 
000358A3 
91C41BAA 
1BAB5AAB 
58C091C4 
008058BO 
91BC4740 
D2O1BO00 
B0024773 
47F090CA 
000E070C 
04000003 
00008AF0 
FF008AF0 
070F2000 
OOOOOOOE 
00000400 
09620000 
OOOEFFOO 
0OOEO7OF 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
00000400 
09620000 
20000000 
E2400000 
08000000 
00000000 
00000962 
070C2000 
0000E240 
8AF00800 
8AF00003 
20000000 
000E070C 
04000000 
00008AF0 


00003000 
C2300000 

00000C56 
FFFF0009 
FFFFFFFF 
BOOOOOBA 
4780910C 
00805 ACO 
BFA73041 
003C58B0 
58A09O5C 
B01CJ50? 
915658B3 
91B050A0 
91100702 
E2400000 
20000000 
E2400000 
08000000 
30003000 
00000962 
070C2000 
OOOOE240 
8AF00800 
8AFO0OO0 
20000000 
OOOE370C 
04000000 
00008AFO 
FF008AF0 
070F2000 
OOOOOOOE 
00003400 
09620000 
OOOEFFOO 
OOOE070F 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
00000400 
09620000 
20000000 
E2400000 
08000000 


OOOOOOOO 
00000200 

00009F02 
FFFFFFFF 
FFFFFFFF 
50A0905: 
41AA0008 
A024581: 
47809110 
91B8BEA7 
49239036 
B00391C0 
91B4 5OB0 
905C88A0 
BOOB BOOB 
00009654 
09620000 
OOOEFFOO 
O0OEO70F 
04000000 
OOOOOOOO 
0000 0962 
OOOOOOOE 
OOOOOOOE 
0000 0400 
0962 0000 
20000000 
E2400000 
08000000 
OOOOOOOO 
00000962 
0700 2000 
OOOOE240 
8AF0O8OO 
8AF0OOOO 
20000000 
OOOE070C 
04000000 
OOO08AFO 
FFO08AFO 
070F2000 
OOOOOOOE 
00000400 
09620000 
OOOEFFOO 
OOOOOOOO 
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The example below shows the beginning of a dump of the BG partition using 
the command DUMP BG when SYSLST is assigned to a line printer. 
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Dumps of, and changes to Real and Virtual Address Areas 

SYSTEM DUMP // OPTION DUMP statement 



If this statement is included in the job stream a dump of the partition, the supervisor 
and/or the SVA will be printed on SYSLST, whenever a program is canceled either 
by the operator or by other cancel conditions. The dump includes a printout of 
the supervisor area, and if the program check is within the SVA, a dump of the 
SVA or parts of it. For this reason the dump is often referred to as a SYSTEM 
DUMP. 

Note: There is no need to insert the // OPTION DUMP statement in a job stream 
if the default option of the DUMP parameter has been specified in the STDJC macro 
during system generation. If however the dump is not required when abnormal 
termination occurs during execution of a particular fob, the // OPTION NODUMP 
statement must be included in the job stream. 

To enable the // OPTION DUMP statement to operate, one of two types of system 
dumps must be cataloged into your system during system generation: 

• A standard system dump, whose printed output is in hexadecimal code 

• A translating system dump, whose output is printed in hexadecimal and 
alphameric codes. 

The dump output includes the following: 

• General registers 

• Floating point registers, if FP is specified for the system 

• Control registers 

• Active communication region address (See Section 4 for a description) 

• Supervisor (see note below) 

• PD area, if PD is specified for the system (see B-3 in this section for details) 

• Label length 

• Partition identifier: BG, F4, F3, F2, or Fl 

• Temporary real or virtual partition. 

• The Shared Virtual Area (See note 2 below). 

Note 1: The LTA (Logical Transient Area) is used to contain the dump program. 
Therefore, the LTA printed in the dump will always contain the B-transients 
SSBDMPBC (if the dump is directed to a line printed or tape unit) or SSBDMPDC 
(if the dump is directed to a disk). 

Note 2: If a program check occurs in the SVA before the dump logical transients 
are loaded and have control, a dump of the SVA is executed. Even if the program 
check occurs in a phase within the SVA, the phase name of which has been deleted 
from the SDL (System directory list) before the dump transients have control, parts 
of the SVA are dumped that contain the phase in which the program check 
occurred. 

When to use 

Insert this statement into job streams for new, modified, or untested programs. 
The partition dump and general register dump can be analyzed and the 
information obtained will help during offline program debugging, 



o 



[ %y 



2.12 Serviceability Aids. 



How to use the dump output 



Dumps of, and changes to Real and Virtual Address Areas 

SYSTEM DUMP 






Begin the analysis by examining the error message issued on SYSLOG and/or on 
SYSLST. If the program check occured within the SVA, the message 

PART OF SVA WHICH CAUSES THE ERROR 

is printed after the dump of the partition in which the program is running, or if the 
entire program is running in the SVA, the message is printed after the dump of the 
program save area. A hexadecimal dump, including storage of the SVA, or a dump 
of the phase running in the SVA addresses in which the program check occurred — 
follows the message. 

The example below illustrates how to use the system dump in conjunction with 
program listings and the linkage editor map in order to isolate a data exception 
program check occurring in a program running in a BGV partition. 

Step 1 : Check for messages on SYSLOG and/or SYSLST. From the message obtain the address at which the 
interrupt occurred and reason for the program check. 





o 



Step 2: Locate the register values printed at the beginning of the system dump. Scan the contents of register 
for unreasonable values. (This may help in later problem analysis.) 




I I 
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Dumps of, and changes to Real and Virtual Address Areas 

SYSTEM DUMP 

Step 3: Locate the linkage editor map and obtain the relocation factor. Subtract this value from the address 
given in the program check message. 

In case of a program check in the SVA, the relocation factor applicable is obtained as follows: 

1. Subtract the instruction address printed in the program check message from the first address 
printed in the dump of the SVA. 

2. Add the result to the start address printed in the assembly listing for the program or phase causing 
the error. 




Step 4: Locate the resulting address (from step 3) in the program listing. This will give the failing instruction. 



003E88 D203 C682 BBD2 04E84 0*304 

003E8E D203 C686 BB02 04E88 04304 

0Q3-E34 0203 C68A BBD2 04E8C 043D4 

(003E9A) |DE03 C676 C5EC| 04E78 04DEE 

TOTETtt! DE03 C67A C5F4 04E7C 04DF6 



MVC 
MVC 
MVC 



PLN, MASKER 
AND. MASKER 
TOT, MASKER 
EDBtpECE+63 

khoToS 



laJe£ -for tffe, eh/k'a&t* jhjzcS <m 

J (fxg/rr) 



Step 5: Compare the hexadecimal code for the instruction in the program listing with the code in the dump. 
It should be the same. 



/) 04068 
1 1 A-S406A 



D406A0 
0406C0 
Jl 0406E0 

040700 
040720 
040740 



CD24F 

47F0B2C2 4780B302 95E0B985 4780B75C 

tcpnrtct 4 p 9Q rAr»ft 4FAnr.60F 1A561A57 

00100SEF 95U/C83F 4r a00 4KA _5Ji50CPB2 

58A0COB2 D203C672 BBD2DE03 C67 

CE105810 C0AE58F1 001045EF 000CD203 

D203C682 BB020203 C686BB02 D203C68A 

C67EC5FC DE03C682 C604DE03 C686C60C 

CE290202 B94DC677 D20BB952 CDEE0202 



10010 45EF00OC 
47F0B24C 4E50C5E6 4E60C5EE 4E70C5F6 
1A584E50 C6165810 CDAE4100 001B58F1 
5860CDB2 5870CDB2 5880CDB2 58J 
0283B936 B9350203 B951C>» , -'B215B93B 
9BD2 0203C67A f ^8 tf2*D203 C67EBBD2 
BB02 bE03 C676CSECI DE03C67A C5F4DE03 
DE03C68A C614D283 B936B935 D212B93B 
B950C67B D210B962 CD9ED202 B972C67F 



■to OK ) 



• Go. ?, 



^ 



Step 6: Locate the location in the program listing that defines the data area used by the failing instruction. Use the 
relocation factor from the linkage editor map to calculate the address of the data area in the dump. 




Step 7: Locate the data rea used by the instruction in the dump. Check if the data is specified for the failing 
instruction. If it is not, continue by identifying the point in the program listing at which the data 
is prepared. 



DfcCt 



041600 
041620 






0416A0 
0416C0 
0416E0 
041700 
041720 
041740 



E2E5C340 O5C5E640 50000048 92201004 47F0301C 40404040 40404040 F3841078 SVC NEW G 0.. 3... 

00609240 1080DC07 10785000 F3841081 00649240 10890C07 10815000 9D004000 .-. ......G.3 6... . 

4770303C 9C 004000 _ 90004000 47303048 47F01010 40404040 40404040 40404040 .0.. 

00000000 00000<E9J 00000000 0000004C 00000000 0000010C 00000000 0000004C Z . 

00000000 00000«C\00000000 0000068C 00000000 0000026C 8004033C 92601004 ..... t . 1/ /: — 

So Z U A^^^tf^^"* *«»"■ * ^rl^V^t\ "jl^Zft 

50000048 47FU3UU. E3U604EZ 4040FZF6 4tfZ02 / __/, . / l\ .0..T0MS i "^^/7^W , „ / 

40202120 40202120 030605C4 D6D54040 40400(//4<tf *) JM4M, <# /fe^S- -<VZ«S* ) ...LONDON Xwjf ;J- o*X^V- 

17800000 84000COO 00040004 17800004 17880 V ( ' <T ' 44B. M>*S K ^C CWC . 

090417A4 60000020 090417C4 6000002F 090417F3 6000001F 09041812 60000021 . . . .- 0- -,.... £x/tA 
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DUMPGEN 



The IBM program DUMPGEN allows you to generate a stand-alone dump program 
that must be used to obtain information about the system under certain conditions 
of system malfunction. 

The dump consists of a printout of real storage (except bytes X'OO'— X'17', X'40'— 
X'4B\ X'BA'-X'BB' and 214 bytes of a non-critical area in the supervisor). Two 
types of dump programs can be generated using DUMPGEN: 

• Translating dump 

• Formatting dump. 

Both programs produce a conventional dump with translation. In addition, the 
formatting dump produces a pre-formatted printout of the DOS/VS interface 
tables. This dump is generated if the DUMPGEN option FORMAT=YES is 
specified. 



DUMPGEN AND 

STAND-ALONE 

DUMP 



o 



Executing DUMPGEN 

Before being able to execute DUMPGEN you must catalog it to the core image 
library. Execute it in any partition by the job control statement or command: 

// EXEC DUMPGEN 

You enter DUMPGEN and read its control statements from SYSIPT. 

Note that SDAIDS may not be initiated during execution of DUMPGEN. 
(SDAIDS are described in Section 2-B.) The two types of control statements used 
with DUMPGEN are ASSGN and OPTN, described as follows: 

ASSGN Statement: ASSGN defines the output device for the stand-alone 
dump program. 



Name 


Operation 


Operand 


(blank) 


ASSGN 


SYSLST, X J cuu' 




o 



SYSLST The only valid logical unit assignment. 

X 'CUU' Must define the address of the SYSLST printer. If the ASSGN 
statement is omitted, thenX'OOE' is assumed. 



,,,-? C 'i 



Q\ 



?' 



<L-* 



■d 



/j 






e> 



n 
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DUMPGEN AND 

STAND-ALONE 

DUMP 



OPTN statement: OPTN defines the type of output generated by the DUMPGEN 
program. 



Name 


Operation 


Operand 


(blank) 


OPTN 


INTR= NO ^ ^•'' , 
Y&S 

DECKS= nnnnnn ^T;/^ 

PPOOL= HO- 9 \^ . 

Y£5 jjP^' 

FORMAT= -NO_ 

YES -^ 

/TAPEipt— - NQ,^ 
YES 



Operands for the DUMPGEN option statement. 

INTR YES produces a DUMP program that, when loaded, enters the WAIT 

state. Either press the INTERRUPT button on the CPU operating 
panel to print the output on X'OOE', or press the STOP button and 
then START button of the printer desired for the output device. 
NO produces a DUMP program that, when loaded, prints out the 
contents of real storage either on the SYSLST printer defined with 
the ASSGN statement or on X'OOE'. 

DECKS Specifies the number of DUMP card decks (punched out on SYSPCH) 
desired, nnnnnn may be any decimal number from 1 to 99,999,999. 
,/' A blank card separates each deck produced. If DECKS is omitted, one 
deck is produced. 

PPOOL YES produces a dump program that, after printing out real storage, 
will print the formatted contents of the Boundary Box and the 
contents of the real storage in sequence of ascending virtual addresses. 
If NO is specified, the last two items are not printed. 

FORMAT YES produces a translating stand-alone dump that formats and displays 
the DOS/VS supervisor tables after displaying the contents of real 
storage. This formatted display depends upon the location of the 
communications region. 

If the communications region cannot be related, the program is 
terminated when the formatted display is to occur. 
In this case the following message is printed on the dump output: 

COULD NOT FIND COMREG BETWEEN CO AND A00, 
FORMATTING WILL NOT OCCUR 

If NO is specified or FORMAT is omitted, a non-formatting translating 
dump is generated. 

TAPEIPL If YES is specified and SYSPCH is assigned to a tape unit, the stand- 
alone dump written on tape may be IPLed directly from the tape unit. 
If NO is specified, or TAPEIPL is omitted and SYSPCH is assigned to 
a tape unit, the stand-alone dump records are written on tape preceded 
by an ASA control character. 
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Dumps of, and changes to Real and Virtual Address Areas 



Control statements for the DUMPGEN operands 



Control statements may be specified in any order; however, the following rules 
apply: 

• All statements may be omitted, but if they are, DUMPGEN assigns printer 
X'OOE', INTR=NO, FORMAT=NO, and PPOOL=NO options. 

• Only one operation and only one operand per control statement is allowed. 

• The last statement processed of a duplicate operation overrides all previous 
statements of the same operation with similar operands (if DECKS=2 is 
followed by DECKS=5, five decks are punched). 

• The name field must be blank. 

• Decimal operands may contain leading zeros. 

• One of more blanks must follow the operand if comments are to be made. 



DUMPGEN AND 

STAND-ALONE 

DUMP 






Job stream example 

The following example is a typical job used to create a stand-alone dump. 



I/10B 

// EXEC DUMPGEN 

Col. 2 

ASSGN SYSLST, X'OOE: 
OPTN FORMAT=YES 

OPTN PPOOL=YES f) Q . < ) l ^ 

_OPTNDECKS=$ 2- ' 

/& 

Note: If a 3221 is the only printer in your installation, the indexing feature 
should be used with great care; shifting the print line to the left 
or too far to the right causes loss of a certain number of characters 
on each line of the dump. 



y 




\ft \\ 



DUMPGEN messages 

The functions of DUMPGEN-to-operator error message routines are: 

• Cancel the job if SYSLOG is not a 3215/3210 or a System/370 Model 125/1 15 
video display unit. 

• Reissue the message if operator response is to press the CANCEL key 

• Process an operator response of END/ENTER as IGNORE 

• Cancel the job if operator response is CANCEL. 

• Ignore the control card in question when the operator response is IGNORE. 

If none of the preceding operator responses is issued, then DUMPGEN assumes 
that a correction has been made and processes it. 
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/f n 

DUMPGEN AND Stand-alone Dump Program \y 

STAND-ALONE 

DUMP This program is generated for your installation using the IBM program DUMPGEN. 

DUMPGEN produces a dump program that is either punched into a card deck or 
stored on magnetic tape. When required, the dump program thus generated can be 
loaded into the system via the standard IPL procedure. 

The stand-alone dump program that is generated by DUMPGEN provides either 
a conventional dump or a formatted dump, depending on the FORMAT option 
used in the DUMPGEN program. « 

Operation 

During execution of the stand-alone dump program, a non-critical area in the 
supervisor is used to load the program. The LOAD ADDRESS of the non-critical 
area is punched (in decimal) in the first card of the stand-alone dump card deck 
punched by the DUMPGEN program. Because of this use of the non-critical 
area it is recommended to use the stand-alone program for a system using a 
supervisor that was used for the generation of that dump. 

The conventional dump prints the contents of real storage locations, but does not 
dump the floating point registers. In addition to the areas dumped by the conven- 
tional dump, the formatted dump prints the DOS/VS interface tables in a more 
readable form. 

For both types of dump the following is printed: 

1. The contents of the general registers, the old and new PSWs, the interruption 
codes, CSW, CAW, and TIMER. f 

2. The contents of real storage in 2k blocks. Each block is preceded by a V_> 
sequence number. 

3. At the end of the real storage dump, page address and status information is 
printed that contains the following information for each page frame: 

• The virtual address 

• The real address of the associated page 

• The sequence number of the 2k block 

• Information that indicates whether the contents of the page frames 
has been changed. 

4. The contents of the control registers are printed after page address and 
status information. 

5. Depending on the options selected, the following then occurs: 

IfPPOOL=YES 

• The formatted contents of the boundary box is printed after the 
control registers. 

• The contents of real storage is printed in 2k blocks in sequence of 
ascending virtual addresses. 



■^ 
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Dumps of, and changes to Real and Virtual Address Areas 

If FORMAT=YES, DUMPGEN AND 

the formatted contents of the tables listed below are printed at the end STAND-ALONE 

of the dump. DUMP 

COM REGS 

PIBs 

AP SUBTASK PIBs (if AP supported) 

PARTITION SAVE AREAS 

LUBs 

PCIL LUBs (if PCIL supported) 

PUB 

ERROR RECOVERY BLOCK 

CHANNEL QUEUE 

FLOATING POINT REGISTERS 

COPIED AND TRANSLATED CCB 

FIXINF EXT. BLOCKS 

COPIED AND TRANSLATED CHANNEL PROGRAM 

IDAL BLOCK QUEUE 

FIXINF BLOCK 

BOUNDARY BOX 

SEGMENT TABLE 

PAGE TABLE 

PAGE FRAME TABLE and PAGE FRAME TABLE EXT 

SELECTION POOL 

The full names of these tables, their contents, locations, and meaning to 
the system programmer during offline program debugging are found in 
Section 4. 

An example of the formatted output of these tables is given in Appendix G. 

The two following illustrations show the information that is printed 
after executing the dump program. 

When to use 

The stand-alone dump program must be used whenever the severity of a 
system malfunction, such as a loop or hard wait state, prevents alternative 
methods of obtaining system information that aids offline debugging. 

Flowcharts in Section 3 indicate when to execute the stand-alone dump 
program. 
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DUMPGEN AND 
STAND-ALONE 
DUMP 




16 General Registers 

Low address storage 
(Formatted). 



Last 2k block of 

real storage. (Without translation. 



First 2k block of real storage 
beginning at byte 0. (With translation). 



2k blocks of real storage, (With translation) 



Last but one 2k block of real 
storage, (With translation). 



Page address and status information 



16 Control Registers. 



The contents of tables and areas "\ 

as listed in the previous text are printed J 

(See appendix G for an 

example of formatted output of these areas). 



PSWS 
EXT OLD 
EXT NEW 
EXT INT 
SVC OLD 
SVC NEW 
SVC INT 
PGM OLD 
PGM NEW 
PGM INT 
MCKOLD 
MCK NEW 
MCK INT 
I/O OLD 
I/O NEW 
I/O INT 
CSW 
CAW 
TIMER 



.V 



FORMAT=YES 



A pictorial representation of the stand-alone dump and formatted 
printout, generated using DUMPGEN options FORMAT=YES 
and PPOOL=NO. 



M? 
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Dumpsof -^o hangesto 



1 6 Gen 



era ' Register. 

L °w address st 
formatted). 



*■*" 2k block of 
rea ' *or ag e. ( W/tho 



ut translation.) 



[ kst2k block of re . t 
be 9'^m 9 atbyteo 39e 



fW, ' th ^n s , at , 0nJ 



2k blocks of 



real 



St ° r ^^ htrans/at . 



on). 



Las t but one yu u, 



' 6 Co "«™i Register 



ion 



B °^DARV 80X 



* blocks of real 
St ° ra 9e,pr/ nted 
,n ^cend/ng 
sequence of 
^ua, addres 

fW ' th ^ns,at/on). 



PPOOl=Y Es 



A P''«oria/ represent • 

' ~MO, and 



PSWs 
E XTOLD 
""" E *TMEW 
E *T IMT 
SVCOLD 
S ^C MEW 
SVC thi T 

W§ PQ MOLD 
PQ MNEW 
p GM INT 
MCK Old 
MCK NEW 

l/O OLD 
I '/O MEW 

'/o /Mr 
csw 

CAW 

t/Mer 




Se ™-ceabiJ ityAick 
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DUMPGENAND A note to the operators 

STAND-ALONE 

DUMP Before the stand-alone dump program is executed, the operator must dump, or 

display and note, the contents of bytes X'OO' through X'17', X'40' through 'x'4B', 
X'BA', and X'BB' of low address storage. (The contents of these bytes will be 
destroyed when the dump program is loaded.) It may be important to the pro- 
grammer to have a note of the contents of the control registers at the time of the 
error. This can be done by (1) executing the store status function or (2) dumping 
or displaying the control registers using the ALTER/DISPLAY feature described 
in Section 2-D. The operator should also display and note the current PSW before 
executing the dump. Also there may be a need to dump the page data set after 
executing the stand-alone dump. For example, the programmer may have made a 
request for a "SYSVIS dump" after the execution of a stand-alone dump. The 
flowchart shown opposite indicates the procedure for loading and executing the 
stand-alone program. 

A note to the programmers 

To ease the task of locating and interpreting the contents of control blocks and 
tables during offline debugging, generate the formatted dump program 
(FORMAT=YES). 

A note to IBM SE/CE 

For any System/370 supporting RAS the serial number and System/370 Model 
type is stored in the first 8 bytes of the RAS linkage area, the address of which 
is located at displacement X'70' of SYSCOM. 

How to use 

Initially the following listed areas should be examined, for what appears to be 
unexpected information. 



(C 



1 . General registers. "let (i ) 

2. Current PSW and old PSWs. J beenote ' V*> 

3. From the PIB table locate the partition ? in control at the time of the error. 

4. Registers and the PSW in the partition save area. 

5. Using the program listing of the program that was running in the failing 
partition, scan the I/O areas, instructions, intermediate results, and 
operands in areas you consider critical to the program. 

6. Use the linkage editor map to locate where the system should load the 
phases. 

7. For further analysis, check the PUB table for any I/O request left out- 
standing, and, depending on the type of the program in error, check the 
CCB/DTF table and label save areas. 

The order in which these areas are examined rests with you, who as programmer, 
will know what the program was expected to do, and approximately what the 
contents of certain registers and I/O areas should contain. 

An example of a stand-alone output is given in appendix G. 

By examining the dump in this way and by consulting the program listing you 
will be able to form an idea of the cause of the error, and to discover where to 
look for further clues or pointers. 

However, the first pointer will depend on the symptoms of the error, the 
environment, what the program was expected to do, any output that became 
available, and incorrect results of calculations. 



Note: Use the information printed at the start of the dump, that is before the print 
out of the last block of real storage. (The contents of low address storage is not 
reliable after the execution of a stand-alone dump program.) 



C 
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DUMPGEN AND 

STAND-ALONE 

DUMP 



Start 



o 



Before executing, dump, 
or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 
X'OO'-X'BF' 




Mount tape on a tape 
unit ensuring that the 
number of tracks and 
density is identical to 
that used when the 
tape was produced 



Set address switches or 
set address in display of 
the tape unit 



I See D-1 -F for Models 1 35, 1 45, 1 55-1 1 
UndD-2-Ffor Models 1 15, 125 
and D-3-F for Model 158 




YES 



IT'- 







© 



3 



o\/ 



V ,^ 



jN-' 



3 



Dump program 
on card deck 



Place card deck in a 
card reader 



Set address switches or 
set address in display of 
the card reader to be 
used 



To next page 
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DUMPGEN AND 

STAND-ALONE 

DUMP 




From previous page 



Press the STOP key, 
the SYSTEM RESET 
key, and the LOAD 
key, in that order 



A wait state occurs if 
INTR YES is specified 
during generation of the 
dump program using DUMPGEN. 



The contents of REAL storage is 
printed in blocks of 2K bytes on 
the line printer specified in the 
ASSGN statement of DUMPGEN 
or the line printer made ready 
after entering the WAIT STATE. 
Other information is also printed 
depending on the type of dump 
program generated by DUMPGEN. 




YES 



Press the INTERRUPT 
key, or the START 
button on the printer 
desired as output device 



The DUMP is 
executed 



r 



The SYSVIS dump utility program 
is described under C-6 in this Section 



V. 



The following procedure executes the SYSVIS dump utility program. This 
procedure copies the PDS to tape or disk which can then be dumped to SYSLIST 
if required during offline debugging. It is also possible to dump the PDS directly 
to SYSLST. To ensure that the contents of the PDS and the allocations of the 
virtual address area are the same as they were just prior to the execution of the 
stand-alone dump the following instructions must be adhered to: 

1 . Re-IPL using identical parameters for the DPD command as specified in the 
previous system IPL. However you must specify N to the parameter TYPE=. 

2. Check for any previous ALLOC commands. You must specify identical virtual 
partition allocations as existed just before the stand-alone dump was executed. 



Example 1 

//JOBDUMPPDS 

// ASSGN SYS000,X'cuu' 

// ASSGN SYS001,X'cuu' 

// DLBL PDSDISK/PAGE DATA SET' 

// EXTENT SYSOOO 

// DLBL S01 DISK/BACKUP FOR PDS', 

// EXTENT SYS001J 1111 1 ,1 ,,0020,180 

// EXEC PDSDM 

/& 



Example 2 

//JOBDUMPPDS 

// ASSGN SYS000,X'cuu' 

// ASSGN SYS001,X'cuu' 

// DLBL PDSDISK/PAGE DATA SET' 

// EXTENT SYSOOO 

// TLBL S01TAPE/BACKUP FOR PDS' 

// EXEC PDSDM 

/& 




x..V. 



YES 



Use the SYSVIS dump to 
copy the PDS to disk. 
See JCS example 1 



Use the SYSVIS dump to 
copy the PDS to tape. 
See JCS example 2 



Wait for message 0V20D 
on SYSLOG then press END 



Save the copied PDS for your 
system programmer and /or 
IBM CE/SE. He may need 
it to complete offline 
program debugging. 



Continue normal processing 
with the next job 
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PDAIDS TRANSIENT DUMP 

PDAIDS (problem determination aids), are routines especially designed to 
provide specific information useful during offline debugging. These routines 
consist of four trace routines, which are described in Section 2-B of this manual, 
and one routine called the transient dump program. 

Transient Dump 

This program is designed to dump, on a program check, areas of the supervisor 
before they are altered. The dump provides: 

• the 1 6 general registers 

• the 1 6 control registers 

• the first X'20F' bytes of low address storage 

• the logical transient area (with the label LTA) 

• j^he physical transient area (with the label PTA). 

This information may be provided on either a printer or a tape unit. When tape 
is used, the tape must be processed by the PDLIST utility program to provide 
readable output data. PDLIST is described in Section 2-B. Both the printer and 
tape modules are reusable, that is a dump occurs with each program check until 
the function is reset. 

The printed dump output is non-translating. 



System requirements 

Because the Transient Dump program is a PDAID function, it requires the 
PDAID initializing phase and a PD area. Refer to "System Requirements" 
for Trace Routines in Section 2-B-l. 
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TRANSIENTDUMP Initializing the transien t dump 



Initializing is done by calling the PDAID program via the job control statement 
// EXEC PDAID. 

The parameters for the dump may be entered through SYSLOG or through the 
card reader assigned to SYSIPT. 

Note: No other PDAID can be executed when the transient dump program is 
initiated. 

If SYSIPT is to be used, the card deck must be punched as follows. 

Punch desired keywords and parameters, as shown in example 1 , into cards. 
Entries may be punched one-per-card, or as multiple entries (separated by commas) 
in a single card. An entry may not be split between two cards. All 80 columns of 
a card may be used, but a card is terminated either by the first blank following an 
entry, or by a GO entry. The last entry of the last card must be GO and the last 
card must be followed by a /* card. 

Note: If an incorrect parameter is read from a card, corrections are requested 
on SYSLOG. 



o 



When the main phase (PDAID) has been loaded into any free partition (one must 
be made available), the following message is issued on SYSLOG: 

4C10DPDAID= 

The operator must respond to this message with one of the following: 

• TD Initiates transient dump. 

• XX Terminates PDAID. 

• END key Indicates that the parameters are to be entered via SYSIPT. 



o 
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Selecting the Output Device T R A N S I E N T D U M P 

The initializer keyword OUTPUT DEVICE selects an output device, which must; 
be specified by channel and unit address, not by symbolic unit. When an output 
device is specified, the initializer checks the address against the supervisor PUB 
and automatically selects the appropriate module for the unit type (tape or 
printer). 

Once the transient dump program has been initiated, it is given control each time 
a program check interrupt occurs. When it has control, the transient dump 
program has highest priority, and the system accepts only external interrupts. 
All system processing is suspended and the operator must ready the transient 
dump output device. 

When to use 

Use the Transient dump when you suspect coding errors in the transient routines, 
for example, your own error recovery routines for devices not supported by IBM. 
The information obtained from the dumps will help during offline program 
debugging. 

Terminating the transient dump 

The transient dump program can be terminated by re-initializing the PDAID 
program (// EXEC PDAID), and responding to the message PDAID= with XX. 
It is also possible to reset (terminate) the transient dump by loading one of the 
PDAID trace routines. 

The following illustration represents the action of the transient dump program if 
a program check interrupt occurs in the LTA. 
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TRANSIENT DUMP 



16 general registers 
16 control registers 



Line printer 

or 

magnetic tape 



527 bytes decimal of 
low address storage 



-—( 



Supervisor transient areas 
(Refer to Section 4 for details) 



Pictorial representation of the information that is dumped. 



Real Storage 



Low Address Storage 



Model dependent 
log out area 



Supervisor Transient 

Area 

(LTAandPTA) 



Background 
Partition 



> 



> 



SUPERVISOR 
AREA 
(Refer to 
Section 4) 



J 






Keyword 


Parameter 


Meaning 


Default 


PDAID 


TD 
XX 


Initiate transient dump. 
Terminate function 


Function 
continues. 


OUTPUT 
DEVICE 
(Note 2) 


CUU or X'cuu' 


Use specified output device for output of 
transient dump function. 




GO 
(Note!) 




End of initializer keyword entries. 

/ 





Note 1: GO is an invalid response to a request for a console correction to card input. 

Note 2: A printer or tape output device must be specified for transient dump. 

CUU or X'CUU' notation must be specified by channel and unit address, 
and not by symbolic unit. 

Two examples of initiating the transient dump immediately follow the flowchart shown opposite. 
Table A-4. Table of parameters for initializing the Transient Dump 
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TRANSIENT DUMP 
Initializing the Transient Dump 



// JOB DUMPTA 
//EXECPDAID 



4C10DPDAID = 



Enter XX 
and press 
END 



Enter TD 
and press 
END 



Press 
END 



4C11D OUTPUT DEVICE = 






Terminate 
Transient Dump 



Select output 
device 



Transient Dump 
is initiated 



Print the Transient 
Area 



Read Parameters 
fromSYSIPT 



A-4 F 




//EXECPDAID 

PDAID=XX 

/* 

// ASSGN SYS005,X'cuu' 

// MTC REW,SYS005 

// EXEC PD LIST 

/* 

/& 1 




The LTA and PTA will be 
dumped on the selected output 
device if a program check interrupt 
occurs in the transient area 
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TRANSIENT DUMP Job stream examples \ y 

The following two examples show job stream to initiate the transient dump 
program. 

Example l,viaSYSIPT: 

//JOBCARDINP7 

// EXEC PDAID Calls for initializer. 

PDAID=TD Calls for transient dump function. 

OUTPUT DEVICE=00E Specifies printer output. 

GO Signals end of input. 

/* 
/& 

Note: A dump is given on all program checks. 

Example 2, via SYSLOG: 

//JOBTYPINPT6 

// EXEC PDAID Calls for initializer. 

PDAID= Console requests function. 

TD and END key Operator specifies transient dump function. 

OUTPUT DEVICE= Console requests output device. 

00E and END key Operator specified printer output. 

An output device must be specified for the transient dump fiction. 

If this is a 321 1 printer and the printer's indexing feature is used, /T~^ x 

it may occur that not the full length of every line of the dump is 

printed. This Joss of characters can be avoided by disabling the "~ 

indexing feature. This is brought by loacfing a new FCB image into 

the printer's FCB in one of the following ways; 

Using the SYSBUFLD program. 

This method is to be used when the transient dump is entered via 

SYSIPT. The job stream as shown in example 1, 

would than have to be as follows: 

// JOB 

// EXEC SYSBUFLD 

FCB SYSxxx,phasename 

r 

II JOBCARDINP7 
// EXEC PDAID 

Using the LFCB command 

This method is to be used when the transient dump is initialized 
by means of the console printer keybord (SYSLOG). The job 
stream as shown in example 2 would then be as follows: 

LFCB X'cuu',phasename 

// JOBTYPINPT6 f~\ 

II EXEC PDAID 4 v _y 

» ■ . 

phasename = the name by which the FCB image is cataloged. 
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TRANSIENT DUMP 



o 





KENSDUMP 




12/06/73 












/V/W 


/Mivuetu >£t<v»y4 




GR 0-F 


00040684 


00008620 


00040298 


00040308 


000085B1 


08040300 


00000000 


OOOO840A 














000084 BC 


00000008 


00040280 


00040688 


00040078 


00000008 


80008300 


000082E8 












CR 0-F 

000000 
— 000030 


004000FF 
OOOOFFFF 

00000000 
00000000 


00OOE64O 
00000000 

00000000 
00000000 


FFFFFFFF 
00000000 

00000000 
07OF2000 


FFFFFFFF 

00000000 

00000000 

0000090C 


00000000 
00000000 

00000000 
000087AO 


00000000 
00000000 

000004A0 

ocoooooo 


00000000 
C2000000 

071DOO0O 
00003AB8 


00000000 
00000200 

0004044A 
00000000 


040COOOO 
FE3B0600 


00002876 
055C0E26 


/<(ec4 *4/ /?SU/ 




I07000000 


000082F6|Xm 


040C0000 


ftoodWtV^. 


• 000060 


040COOOO 


OOOOOBCC 


ooocoooo 


0O00A5OC 


04080000 


0000013A 


040C0000 


00000B10 


00000540 


00000080 


00020007 


00060001 \ 




000090 


12042003 


00020000 


00000000 


000001CC 


00000000 


00000000 


20000060 


000002C0 


OOOOOOOO 


00000100 


00000130 


OOOOOOOO \ 




OOOOCO 
• OOOOFO 


00000000 


00000000 


00000000 


00000000 


00000000 
00000000 


00000000 
00000000 


00000000 
00000000 


00000000 
00000000 


00000000 
00000000 


OOOOOOOO 
OOOOOOOO 


OOOOOOOO 
OOOOOOOO 


OOOOOOOO \ 

00000000 1 












000120 










30000000 


00000000 


00000000 


00000000 


00000000 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO J 




_ 000150 


/CfQ'V a-j-XTT 


0/17-/1 


30000000 


00000000 


00000000 


00000000 


00000000 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO / 




• 000180 










30000000 


00000000 


00000000 


00000000 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO / 




000180/ 


Ojt/I}^, JiJIj^Ao 4f<*^»0 O^ 


tgZnugx/ dooooooo 


00000000 


00000000 


00000000 


00000000 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO / 




_ oooiEor 


jr~* /, 








30000000 


00000000 


00000000 


00000000 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO / 




LTA \l 
_ 0082E8 
• 00831M 


yCcu^u^ua- ffie. 


KVOFOOE 
9T013002 


28004590 
4710F08A 


F2669101 30044710 F09495FE 
91023002 4710F080 9108A087 


700047B0 
4710F076 


= ZZFt 

F0389551 
9110A087 






^/ 




? 
80044780 
47E0F05E 


F038O300 
94EFA087 


F4188004 
0A0B9550 


5B5BC206 


D7C5D540 


'9550F418 


4780F0B6 


/- oosHs 


F4184770 


F0705860 


20080201 


40266006 


4110F41A 


OA024110 


F42A94F7 


A0870A02 


4110F43A 


94F03002 


OA024110 


F43294FE 




— / 008378 


30020A02 


4110F422 


0A020A00 


91801002 


4710F0A6 


OA079120 


10024710 


F0B007F9 


92FFF419 


07F94160 


F3F04060 


100A4590 




$#)/W 008308 
J2" 008408 


F09A9108 


F2D74710 


F00C0605 


40204020 


4780F038 


96044003 


47F0F03B 


9104A087 


47E0F0EC 


94FBA087 


47F0F104 


4160F3F8 




4060100A 


4590F09A 


4160F400 


4060100A 


4590F09A 


95FFF419 


4780 F038 


9U8A087 


4770FUC 


91112014 


4710F126 


0503F2EE 




F40E4780 


F12CD205 


F2F2F412 


D5054020 


F4084780 


F234D505 


4020F2F2 


4770F15A 


0505F2F2 


F4124770 


F2349110 


30024710 




• 00 8438 


F15A9112 


201447E0 


F234D76B 


F26AF26A 


9280F288 


9203F282 


0201F286 


8OO4920A 


F28AD201 


F2848000 


9206F291 


0205F2B4 




008468 


F2D69201 


F2899550 


80044780 


F1B89218 


F2919214 


F28A0217 


F2BEF2D6 


9204F289 


926CF30C 


95538004 


4770F1B8 


9209F291 




_ 008498 


9205F289 


925DF30C 


D205F292 


40200200 


F2A58005 


D201F29E 


400B0201 


F2A24012 


0201F2AO 


40010200 


F2A44000 


0203F2A6 




• 0084C8 


400E0201 


F2984026 


95508004 


4770F214 


D209F2AA 


40300602 


40004000 


4780F234 


D7024000 


4000D733 


40084008 


9250F3DC 




0084F8 


47F0F230 


0213F2AA 


40300602 


40004000 


4780F234 


07024000 


4000D73B 


40084008 


4590F24A 


9110A087 


4710F240 


96044003 




_ 008528 


D2054020 


F2F247F0 


F0380203 


F266F3DC 


18514110 


F2660A2C 


9180F268 


4710F262 


OA071815 


07F958A0 


001458B0 


A0885830 




• 008558 


B01C4110 


F3E09118 


A0874780 


F2A24000 


10064590 


F3821821 


45E0F394 


1B444347 


00008940 


00014844 


30345A40 


303047F0 




008588 


F0B69180 


A0594710 


F0701820 


91033002 


4740F34E 


9104 A058 


4710F32E 


91013004 


4710F320 


1B0D18C0 


412CD000 


95002000 




_ 0085B8 


4770F320 


58220000 


95FF2007 


4780F2F0 


95202014 


4740F2F6 


95282014 


4720F2F6 


96013004 


07F99532 


20144770 


F31845E0 




• 0085E8 


F39495FE 


70004780 


F3180300 


F4188004 


9560F418 


4780F2F0 


41DD0004 


47F0F2C8 


94FE3004 


18205822 


000047F0 


F34E5820 




008618 


F4AC950O 


20044780 


F34A9102 


A05847E0 


F0705822 


000047FO 


F34E5822 


000495FF 


20074780 


F0709520 


20144740 


F3669528 




_ 008648 


20144700 


F0700201 


10062006 


45E0F394 


1B664360 


70008960 


00014846 


30345A40 


30304160 


F2064060 


F3F24160 


F2EE4060 




• 008678 


F3FA07F9 


487A007C 


488A002E 


48887002 


487A004A 


0200F3BB 


7000 1B77 


43720007 


91012006 


47E0F3BC 


41770000 


1A781A77 




0086A8 


4A7A004C 


1B884387 


00008980 


00034A8A 


004007FE 


00000000 


00000000 


00300400 


00001500 


OOOOOOOO 


OOOOOOOO 


20000000 




. 0086D8 


04000206 


20000018 


020002EE 


2000000C 


07000400 


20000001 


00000000 


OOOOE506 


03F14040 


40404040 


000056 5B 


C206D7C5 




• 008708 


D5F15B5B 


C2D6D7C5 


D5C45B5B 


C201C3O6 


D7E35B5B 


C206D4E3 


F0F15B5B 


C20604E3 


FOF50000 


OOOOOOOO 


00005C00 


012C000O 




008738 


84000000 


92600004 


00006060 


C2C76060 


C306D409 


C5C74040 


C2C740C1 


C4C4D940 


C9E240F0 


F0F0F4C1 


F003C203 


E3E80740 




m 008768 


40C8C5E7 


4003C5D5 


C7E3C840 


C9E240F0 


FOFOF060 


D74BC44B 


604040C 1 


09C5CIOO 


000020F2 


F14BF1F3 


4BF1F660 


80041224 








/^ 


fjf6 


2- <?/ f& 


ic&Ln& 


-cnwitca&ri 


- X 'c 


7' 
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• 008E60 


5B5BC1C2 


C5D9E9F1 


28005890 


00144890 


908458C0 


008048A0 


905A9287 


AOOO9102 


903547E0 


B02E48A0 


C05847F0 


B03248A0 




008E90 


906E4AA0 


905A1B88 


BF87A005 


58108O2C 


4570B068 


48F0C046 


58E0C004 


9280AOOO 


9127A008 


4780B05C 


9283A000 


5860C000 




_ 008EC0 


D2016006 


B0C407FE 


95FF1002 


4780B09A 


1B554350 


10028950 


00035A50 


C0249500 


50044780 


B0B895FF 


50004780 


B09A1B44 




• 008EFO 


43405000 


185447F0 


80764111 


000895FF 


10004770 


B0689283 


A0009680 


A00148A0 


905A94DF 


A00807F7 


5010802C 


0AO348AO 




008F20 


905A07F7 


D9C 10201 


00BA3000 


4A20905A 


18A248F0 


C00847F0 


B23C4100 


B29094A0 


00084570 


B14A0508 


B02AB342 


4780B21A 




m 008F50 


D505802A 


B3364770 


B14A18A0 


4850C02C 


4860907C 


41AA0010 


41660010 


D501B031 


B3424780 


B120D501 


B031A002 


4770B142 




• 008F80 


9180600F 


4780B1A8 


4140B21A 


4100B208 


9226B267 


9220B264 


4570B14A 


9260B264 


07F44650 


810492F2 


B2ABBE07 


B2614100 




008FBO 


B260BE07 


B31F4100 


B02ABE07 


B2710708 


B02AB02A 


4100B34C 


BE07B269 


4110B316 


0A0F9180 


10024710 


B17C0A07 


9120B318 




_ 008FE0 


4710B21A 


9218B267 


9101B31A 


4780B19C 


4100B270 


BE07B31F 


47F0B15E 


0608B02A 


B3424100 


B2A807F7 


4100B2C0 


91029035 




• 009010 


47E0B1E6 


4120000F 


4B20C02C 


4830C02C 


89300004 


4A30905A 


41330010 


05013002 


A0024770 


B1E29601 


3000960C 


300F921O 




009040 


30014620 


B1C89580 


A0004780 


B14A9110 


A0OF4770 


B14A9601 


A00048F0 


C00A47F0 


B23C4100 


B2FE9218 


B2679220 


B2644570 




_ 009070 


B14A9260 


82644 7F0 


B03E48F0 


C04658E0 


C0049280 


00009127 


D0084780 


B2329283 


00005860 


C00092C1 


600707FE 


91400008 




• 0090A0 


4710B248 


94F 80008 


4BA0905A 


42A0902F 


91029035 


4780B21E 


42A0CO5B 


47F0B21E 


090090F0 


60000018 


010091AC 


60000004 




009000 


OA008E8A 


20000009 


F0D7F6F0 


C440C905 


E3C5D9E5 


40D9C5D8 


40404040 


40FOFOFO 


F1C9F4F0 


C44009C5 


0BE4C5E2 


E340C3C1 




_ 009100 


D5C3C503 


40404040 


F1E2F0F1 


C440C9D5 


E5C103C9 


C440E2E3 


C1E3C5D4 


C5D5E340 


F1C9F3F2 


C440C109 


C5C140D5 


D6E340C1 




• 009130 


C3E3C9E5 


C5404040 


F108F6F2 


C940C3C1 


05C3C5O3 


40C60609 


40D706E6 


C5D940D7 


0906C709 


C1D440C9 


C70506D9 


C5C4F007 




009160 


F8F9C940 


C961D640 


C3C105C3 


C5D340C9 


C7D50609 


C5C40003 


81000800 


00040000 


90C0O00O 


9008F0F1 


F2F3F4F5 


F6F7F8F9 




_ 009190 


C1C2C3C4 


C5C6C3C1 


05C3C503 


C9C7D5D6 


D9C54040 


40404040 


40404000 


C1094040 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 




• 0091C0 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 




0091F0 


00000000 


00000000 


00000000 


00000000 


00000000 


00004040 


40404040 


40C3C3E2 


E67EF0F1 


F1F0F0F4 


F0F4F2F0 


F0F2F0F0 




m 009220 


FOFOFOFO 


40C3C3C2 


7EF0F4F0 


F4F0F040 


E2D27EF6 


F1F6F1F0 


FOFOFOFO 


FOFOFOOO 


F0D7F0F8 


C1404040 


40C905E3 


C509E540 




• 009250 


D9C50840 


E2E8E2D3 


E2E37EF0 


FOC56000 
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Transient Dump output 

This example shows the output obtained from the transient dump program. (The dump is 
output when a program check occurs in the transient area.) 

The programmer's remarks on this example indicate the main points of interest to aid offline 
debugging, however this depends on the error symptoms and system environment. 



o 
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SUPERVISOR 

COMMUNICATION 

MACROS 



Dumps of, and changes to Real and Virtual Address Areas 

PDUMP (partial dump) macro 

This macro instruction provides a hexadecimal dump of: 

• The general purpose registers 

• The floating point registers (if FP is supported) 

• The control registers 

• The virtual storage area contained between two address expressions. 

The addresses can be expressed in decimal or hexadecimal or in register notation 
and need not be confined to any one partition. 



Name 


Operation 


Operand 




(name) 


PDUMP 


address 1 , 


address 2 






(r) 


(r) 



Address 1 specifies the start address of the 
storage to be dumped. 

Address 2 specifies the end address of the storage 
to be dumped. 

(r) one or both of the addresses can be 

specified in any of the general registers. 

The contents of registers 0-1 are destroyed, but the CPU status is retained. Thus, 
PDUMP furnishes a dynamic dump (snapshot) that is useful for program checkout. 
Processing continues with the next user instruction. 

The dump is always provided by SYSLST on 121 -byte records. The first byte 
is an ASA control character. If SYSLST is a disk drive, the user must issue an 
OPEN macro to any DTF assigned to SYSLST after each PDUMP that is 
executed. The OPEN macro updates the disk address maintained in the DTF table 
to agree with the address where the PDUMP output ends. If OPEN is not issued, 
the address is not updated, and the program is canceled when the next PUT is 
issued. 

The specified addresses are checked against the end address of virtual storage. If 
address 1 is higher than the end address of virtual storage, or if address 1 is higher 
than address 2, the PDUMP macro results in no operation. If address 2 is higher than 
the end address of virtual storage, address 2 is automatically set to that address. 

If address 1 and 2 are identical, only the contents of the general registers, the 
control registers and floating point registers are dumped. (Floating point registers 
are dumped only when the supervisor supports the floating point option.) The 
dump output can be either standard (non-translating) or translating, depending on 
the dump program cataloged in your system transient library. 

Note: Addresses for this macro may not be specified by register notation for 
programs eligible to run in the SVA (shared virtual area). 
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Dumps of, and changes to Real and Virtual Address Areas 



When and how to use 



o 



PDUMP is useful when you need to know the contents of specific virtual storage 
areas at specified points in the program during program execution. For example, 
you may want to examine the contents of storage areas that are being modified 
during program execution, such as I/O areas. 

The following example illustrates the use of the PDUMP macro. 



SUPERVISOR 

COMMUNICATION 

MACROS 



003C7E D24F C2BF C2BE 04ACI 04AC0 
003C84 0227 C2BF CD4F 04AC1 05551 



400 OUT CANCEL 

405 *»****»**»*•****•*»****♦*•»•****»**»»»«*****•*«**»•***»****♦*»»•***»*»* 

406 *L00P TIMER ROUTINE* 

407 *********************************************************************** 

408 TININTR NVC BUGSWARN|BUGSMARN-1 

409 NVC BUGSHARNI40ltCHKPTMRN 

410 PUT TYPOUT1 

415 PDUMP L00PCNT.L00PCNT+3 DUMP LOCATIONS USED AS COUNTER 

420 * FOR THE LOOP AT EACH TIMER INT. 

421 EXIT IT 

^24 »»»««*»»*****»***«*****»*»***»**»**»****«****»*»*»***«»******»*»*»**»** 

425 *END OF LOOP ROUTINE* 

426 *********************************************************************** 



C/Tx/3/. 



This source code listing shows the PDUMP macro where the programmer needed 
to know the contents of an area used as a counter. 

The following dump printout was obtained when the program was executed. 



• 




KENTQMS1 




12/06/73 












PAGE 


1 1 


• 
• 


GR 0-7 
GR 8-F 
FP REG 
CR 0-7 
CR 8-F 

041680 


00041E10 
00000001 
00000000 
004000FF 
0O0OFFFF 


00041E08 
0000CA34 
00000000 
0000E640 
00000000 


00000049 
00000013 
00000000 
FFFFFFFF 
00000000 


00000000 
4004007A 
00000000 
FFFFFFFF 

00000000 


00000000 
0004107A 
00000000 
00000000 
0000 .000 


00000050 
07C8C1E2 
00000000 
00000000 
00000000 


0000001O 
8004050E 
00000000 
00000000 
C2000000 


00000002 
000422F8 
00000000 
00000000 
00000200 

OOO0CA34 




" fex/tm 






Restriction: 

The message INVALID ADDRESS SPACE is printed on the dump output if the 
dump includes storage areas considered to be invalid address space. 

The definition of invalid address space is listed under "Restrictions" in the 
description of the ALTER command. 
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SUPERVISOR 

COMMUNICATION 

MACROS 



DUMP macro 

This macro, when assembled into your program and executed, will dump the 
following system information: 

• The general registers 

• The floating point registers (if FP is supported) 
The control registers 

The active communication region address (see Section 4 for a description) 
The supervisor 

The PD area (if PD is specified for the system; see B-3 in this Section) 
The label length 

The partition identifier BG, F4, F3, F2, or Fl 
The temporary real or virtual partition issuing the macro. 



Name 
(name) 


Operation 
DUMP 


Operand 



If the program or main task issued the macro, the job step is terminated 



JDUMP macro 



Name 
(name) 


Operation 
JDUMP 


Operand 



If the program of main task issued the macro, the main task (the whole job) is 
terminated and a dump is made of those areas listed in the description of the 
DUMP macro. 



o 
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Dumps of, and changes to Real and Virtual Address Areas 






The following considerations apply to both the DUMP and JDUMP macros: 

1. If a subtask issues these macros, the subtask is detached, the job step or job, 
respectively, is not terminated, and the dump described above is executed. 

2. The dump is always provided on SYSLST, which, if disk or tape, must be 
OPENED. 

3. If either macro is issued by a program running in real mode, the temporary 
real partition is dumped. However, if these macros are issued by a program 
running in virtual mode, the whole virtual partition is dumped. 

4. The dump output can be either standard or translated, depending on the type 
of dump cataloged into your system during system generation. 

5. The LTA (Logical Transient Area) is used to contain'the dump program; 
therefore, the LTA printed in the dump will always contain a B-transient 
$$BDUMPB (if the dump is directed to a line printer or tape unit), or 
$$BDMPDC (if" the dump is directed to a disk drive). 



SUPERVISOR 

COMMUNICATION 

MACROS 



o 



When to use 

By coding these macros into your source listing you can ensure that a dump of 
the supervisor and of the partition issuing the macro is executed. 

For example, you may require a partition dump when certain conditions arise 
during program execution. This is accomplished by programming a branch to 
the DUMP (or JDUMP) macro written in the source listing. The JDUMP 
macro must be used when it is necessary to terminate the job after entering the 
routine that issued the macro. The DUMP macro is used when termination only of 
the job step is required, for example, during program testing. After termination of 
the job step in which the macro was issued the job steps after that are still 
executed. 
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Two series of trace routines are provided on the System/370: PDAIDS and 
> SDAIDS 

These aids enable information to be obtained from the system at the time of a 
malfunction. They are aids for further error isolation, and are usually initiated 
during a rerun of a troublesome program after a first analysis of the problem. 
The type of trace to use for a particular problem depends on the result of the 
first analysis and how much more information is required to help in further 
isolation of the error. 

This section is divided into two parts: 

Part 1 describes the PDAIDS, and part 2 describes the SDAIDS. 



Trace Routines 

PDAIDS 




PART 1 PDAIDS 

General description 

There are four trace routines that can produce printed output of certain events 
which occur during the execution of programs. 

The trace routine will: 

• Record I/O operations (I/O trace) 

• Record the order in which phases and transients are called (Fetch/Load trace) 

• Record the order in which supervisor calls (SVCs) are executed (Generalized 
SVC trace) 

• Record the order in which either an SVC or an SVC 31 , and I/O 
interrupts occur. (QTAM trace). 

On the occurrence of an event, an entry is generated which, by selection of the 
trace, can be recorded on magnetic tape, printed on a line printer, or preserved 
either in the PD area or, if specified, in an alternate area of real storage. 



Caution 

The effect on the operation of programs currently running in the system 
that are time dependent, for example, a program using MICR or teleprocessing 
as input/output, must be considered before using this serviceability aid. 
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Trace Routines 

PDAIDS 



Page of GC33-5380-1, 
revised June* 30, 1974, 
by TNL SN33-8780 



System requirements 



Before any PDAID function can be executed, the following requirements must 
be met: 

• During the system generation, specify a minimum value of 1400 in the PD 
parameter of the FOPT macro. (The maximum value is 10,240). 

• If data provided by the trace routines is recorded on magnetic tape, use 
the PDLIST program after tracing is complete to obtain a printout of the 
tape. 

All PDAID modules are distributed by IBM in the core image library. 
They are self -relocating for initialization in any real or virtiual partition 
(6K or greater) of a multiprogramming system. 



Restrictions: More than one PDAID trace routine cannot operate concurrently. 
This also applies to the PDAID Transient Dump program described in Section 
2-A-4. Therefore, more than one program rerun must be executed if more than 
one PDAID function is used to gather information about a failing program. 



Using PDAID and SDAID concurrently: IF SDAID is active it must first be 
terminated before initiating a PDAID trace in core-wrap output mode in an 
alternate area. 



Modes of output 






Line printer: (not available as output mode for QTAM trace) Examples in this 
section show the trace outputs when the output device is a line printer. An 
asterisk on the print-out indicates that at least one event (trace entry) has been 
overwritten. This occurs when an overflow is caused in the trace table in the 
PD area (described in B-3) or in an alternate area. This may occur when the trace 
output device, or its control unit, or channel, is shared with other programs 
running simultaneously. 

If the printer is not ready or has an error condition, message 4C24A NO I/O TO OD 
is printed on SYSLOG and the system waits for the END/ENTER key to be 
pressed after the printer is made READY. 

Magnetic tape: This mode of output collects and writes on an unlabled tape the 
trace entries that occur during execution of a job stream. 

The events are written on tape in core image (unprintable) format. 

The tape must be processed using the PDLIST utility. The tape unit must be 
assigned temporarily or permanently to SYS005 and SYSLST assigned temporarily 
or permanently to a line printer in order to obtain readable listings of the events 
traced. Examples in this section show the output format after using the PDLIST 
utility. 

If the tape unit is not ready or has an error condition the message 

4C24A NO I/O TO OD 

is issued on SYSLOG and the system waits for the END/ENTER key to be 
pressed after the tape drive is made READY. 
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Core-wrap: This mode of output preserves a fixed number of trace entries in either 
the PD area buffer or an alternate area taken from the main page pool. If the 
alternate area is specified, the PD area buffer is not used. When the area is full, the 
oldest entry is overwritten by each new entry. 

When core-wrap in the PD area is specified, the PD area must be dumped. The 
dump should normally be executed on the occurrence of a system malfunction 
when the last few trace event entries are required to aid offline debugging. 
Dumping and locating the PD area is described under B-3 in this section. 

Table B-3 lists the length of each type of trace entry, the locations, and the 
maximum number of entries that can be preserved in the minimum PD area 
buffer size. Use the table and a dump of the PD area to locate the oldest and 
newest trace entries. 



Trace Routines 

PDAIDS 




Core-wrap in an alternate area: If many events are to be recorded in the core- 
wrap output mode and the PD area is considered to be too small, specify an 
alternate area large enough to contain the trace event entries. 

Specifying and dumping an alternate area is described under B-4 in this section. 

When an alternate area is specified, the real storage taken from the main page pool 
is returned to the main page pool on termination of PDAIDS. Before the alternate 
area is released, its contents are dumped on the device assigned to SYSLST. 
(See "Termination of PDAIDS.") 






When to use the core-wrap output mode: This output mode is useful when no 
output device is available, or when time required by the output operation is not 
available. This would be the case for example, when a PDAID output device 
interferes with time-dependent programs example, when a PDAID output device 
interferes with time-dependent programs using the I/O channels. It should also be 
specified when only the last few trace event entries are necessary to aid in offline 
debugging. (This reduces the task of searching through masses of output.) 

Terminating PDAIDS 

Any trace routine can be terminated by re-initializing the PDAID program with 
the job control statement // EXEC PDAID, and responding to the message 
PDAID= with XX. It is also possible to reset (terminate) one trace routine by 
loading another. 

Terminating core-wrap output in an alternate area 

When the core-wrap output is selected, SYSLST must be assigned to either a 
line printer, a tape unit, or a disk drive, before responding with XX to the 
message 4C10D PDAID=. 

For example: 

// ASSGN SYSLST, X'OOE' 
//EXEC PDAID 

If SYSLST is unassigned, the contents of the alternate area is overwritten when it is 
returned to the main page pool. 

PDL/ST 

Whether the PDAID function uses a printer for its output device, or the PDLIST 

program prints the output of a tape unit, the data printed out is identical. 

PDLIST is initiated by the command: 

//EXEC PDLIST 

PDLIST then prints on SYSLST the contents of the tape reel (it can include the 

output of more than one PDAID function) mounted on SYS005 . No tape labels 

are required. 

Note: The data can only be printed using PDLIST if the device assigned to 
S YSLST is a line prin ter. 
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Description and operation 



Input/Output Trace 

This trace enables the I/O activity of programs run under DOS/VS to be recorded 
for offline analysis. The format of the data recorded in the PD area either in a 
trace table or, when using the core-wrap output mode in a rotating buffer, is as 
follows: 

Length of one entry = 18 decimal bytes i 



On the occurrence of an I/O interrupt; 



Device 
Addr 



— | — | — I — T 

l/OOLDPSW 
I I I L 



i — i — r 
csw 

J I L 



On the occurrence of a START I/O instruction 



E2 40 



Device 
Addr 



1 1 I 

CCB ADDR-R1 



i i i r 
csw 

J I I L 



— Condition Code 

If the entry is made due to CSW stored 
on a START I/O instruction the CCW 
address in the CSW is set to zero. 

Notes: 

1. The PSW and CSW are described in E-2 of this Section. 

2. The CCB is described in chapter 6 of Section 4. 

3. General purpose register usage is described in chapter 10 of Section 4. 

4. The CCB address and the CCW address in the CSW are virtual addresses. 

Either of these occurrences is referred to as an I/O event. 

By selection of the trace output device, the event can be: 

• Recorded on magnetic tape 

• Printed on a line printer 

• Preserved in the PD area 

• Preserved in an alternate area 

When magnetic tape output is used, the tape must be processed by the PDLIST 
utility program to provide a formatted output on a line printer. 

The modes of output and PDLIST are described under B-l in this Section. 
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Trace Routines 

Tracing Options: The I/O trace function provides the following options: PDA IDS 

• Trace all I/O activity on the system. 

• Eliminate a maximum of three devices. 

• Limit trace to a maximum of three devices. 

The trace limiting options are specified by the initializer keywords IGNORE 
DEVICE= or TRACE DEVICE=. All I/O activity is traced if one of these key- 
words is not specified. The two keywords are mutually exclusive: when one is 
specified, the other becomes invalid. 

The trace limiting options are invoked by specifying the channel and unit 
addresses (X'CUU' or CUU) of the appropriate devices. Symbolic device 
references (SYSxxx) are invalid. 

Note: If the trace output device is being used by a problem or control program 
simultaneously with the PD AID program, I/O events for the PD AID program 
are ignored (not traced). Because of this, it is not necessary to ignore the trace 
output device. 

When to use: Use the I/O trace to check that the I/O interrupts within your 
system are correct during the execution of programs. 

You could use it, for example, in a multiprogramming system where the status 
of I/O units is suspected of causing incorrect I/O interrupts. An I/O trace output 
will inform you about the sequence of SIO/ I/O interrupts and about the 
status of I/O units at the time of interrupt. 

The next two examples show the output obtained from an I/O trace. 
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OOE 070C20000000090C 
00E 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070F20000000090C 
OOE 070F20000000090C 
OOE 070F20000000090C 
OOE 070C20000000090C 
OOE 070F20000000090C 



1004094008000000 
1 004094008000000 
1004094008000000 
1004094008000000 
1004094008000000 
1004094008000000 
1004094008000000 
0000000004000000 
0000000004000000 
0000000004000000 
0000000004000000 
0000000004000000 
0000000004000000 



OOE 070F20000000090C 0000000004000000 
OOE 070F20000000090C 0000000004000000 
OOE 070C20000000090C 0000000004000000 
OOE 070F20000000090C 0000000004000000 
OOE 070F20000000090C 0000000004000000 
OOE 070F. jCnrfZ, 0&4. & 104000000 

sio oooo' $j t+tiJ&o&n, 'osoooooo 

SIO OOOOi yN^ 104000000 



SIO OOOOOOOE00040910 0000000004000000 
SIO Q000000E00040910 0000000004000000 



SIO OOOOOOOE" 



"0004000000 






sio oooooooe fttzot^ e#fry 

sio oooooooe/^*'- '/o (*Ue#*cyM ft4*ri 



odbrttz. ac3%/ 



"A 



381 070C2O0OO000O9OC 100408B80CO0OOO0 



/sToooooT 



SIO O0OOOO0E00040910 0000000004000000 



SIO OOOOOOOE00040910 0000000004000000 
SIO 00O00O0E0OO4091O 0000000004000000 
SIO OO0O0OOEO0O4091O 0000000004000000 



OOE 070C20000000090C 
J040006TJT>s, OOE 070C20000000090C 
I OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C2O000000O90C 



1004094008000000™\ 
1004094008000000 / £y*£<Jil 
1004094008000000 V -frVi 
1004094008000000 j 00 £ 
1004094008000000 1 
1004094008000000 ' (gx /S AT)\ 



An example showing an I/O trace output printed on a line printer used as the 
PDAID output device. 





















D 

a* 


Z\ 0-7 
t Z\ 8-F 

POAREA 

009480 
0094AO 

| 009 4C0 
0094EO 
009 500 

| 009 520 
009540 
009 560 

> 009580 
0095A0 
0095CO 

| 0095EO 
009600 
009 620 

| 009640 
039660 
009680 

k 009 6A0 
009 6C0 
0096E0 

| 009 700 

' 009720 
009740 

| C09760 

' 009780 
0097A0 

| 0097Z0 

' 0097E0 
009800 

| 009820 

' 00 9 840 
009860 

i 009880 

* 0098A0 
0098C0 

| 0098E0 
009900 
009920 

| 009940 
009960 
009980 

| 0099AO 

' 009 9:0 
0099E0 


804000E0 O0OOF6O0 
0000E300 00000000 

E3D37EF3 F8F07000 
00003000 00004798 
FFFFFFFF FFFFFFFF 
FFFFF=80 800047AE 
50C091C4 58A00014 
47F09084 95FFA0O2 
00004111 000058:0 
58610020 19AB4740 
B00347"0 910CBFB7 
078A070A 49209038 
078A0501 B00691C8 
91B307 1: A 58B091B8 
001842AB 00029430 
47F09U0 58A1O01C 
00009924 000099FC 
8AF30303 OOOOOOOE 
8AF0OOOO 00000400 
20003000 09620000 

ooo=r>7tr. 20000000 


FFFFFFFF FFFFFFFF 00000000 00000000 00003000 00000000 
00000000 00000000 00000030 00000000 C2000000 00000200 

1000099FF 0000479C 0000153E OO0OB44E OOnjnrRA nnjjnciFn? 
00OO3AA4 00001030jID7:4C1C9 C4C9 E3E6 1*1^0009 FFfTfTTT-— ^ 
FFFFFFFF 3 Fr f ."FFFFFFF FFFFFFFF 
47F0915C 581 CfZ,/' ~S ^ fc~.Jsr**/ 103000BA 50A0905C 
48AOA040 491 D «W fT ° WT&OftK h780 910C 41AA0008 
4733910C 1B( ry / V __- // I0805AC0 A024581; 
91C49120 10( ffCflKSL. /ctsfr<2s IFA70041 47809110 
90FE41CB 00' / I03C58B0 91B8BEA7 
B0454770 931 I8A0905C 49209036 
078A070A 49; 101C3502 B00391C0 
078A58B0 91B841BB 001259BO 91BL4743 915658B0 91B450B0 
4400906B 502B0002 501B0006 D2013000 91B350A3 905:88A3 
e0O29120 10064710 919C9130 B0024770 9113D702 B00BB00B 
50AB0006 9133B3D2 47809192 47F090CA E2400000 00009654 
C4E4D400 00002330 D5E7FFFF 0O0E070C 20000000 09620000 
070F2303 33033962 03300030 0400.0003 — /)„- /—. , /— 
O0O0000E 070C2000 000009>?--015008AFO UnJL <*&**■ e+Ut-0/ -^ 
00000400 000OE240 OptfOOODE FF008AF0 00003000 04000000 
09620000 8AF00B00 jrfoOOOODE J7PF2O00 0000396? 00030000 


■2-/0 fruig-. <yn. kr& <*x 
ff /fcoo /u&n . 








H..0. /3**4j6 MasfnJC 


























N..":::::::"s" :::: 




X:::::::::o.. :::: 




04000000 [E24OO0OO 
000' • — r-"-~K^ 

000^ e cw 

096 4W4CC On a 

E24 5<W" I/O 
080 . v, \_^ 

000 

070 

0000: i't 'J UUUOUOOt 
8AF33300 OOOOOOOE 
8AF000OO 00000400 
20003000 09620000 

000E070: 20000000 

04003000 E2400000 
00003A=0 08000000 
FF003A=0 00000000 
O70 c 200O 00000962 
OOOOOOOE 070C2000 
00000400 00O0E24O 
09623000 8AF00800 


OOOEFFOO 8AF00300 00000430 0000|030E 070C2000 00000962 










~Z-/0 obfOVL <Mn&fi3^Ua 04000000 000E070C 

J~ ^_- f, •> / 00000000 04000000 

#tt« e*t*/-lls L ° tt-J 00000962 00008AFO 

000000 096200^0 00000400 0OOOE240 OOOOOOOE FF008AF0 

0EO70C 20300000 09620030 8AF00800 OOOOOOOE 070F2000 

300000 E2400300 OOOEFFOO 8AFOOO0O 00000400 OOOOOOOE 

008AF0 08000000 0O0EO70F 20000000 09620000 00000400 

FF008AF0 00030000 04000000 000E073C 20000000 09620000 

070F?000 30000962 00303330 04000030 E2400000 OOOEFFOO 

OOOOOOOE 070C2000 03003962 00008AF0 08000000 000E070F 

00000400 3000E240 OOOOOOOE FF008AF0 00000000 04000000 

09620000 8AF00800 OOOOOOOE 070F2000 00000962 00000000 

OOOEFFOO 8AF00300 30003400 OOOOOOOE 070C2000 00000962 

000E070F 20000300 09623000 00000400 00O0E24O OOOOOOOE 

04000000 00OE07OC 20300000 09620033 8AF00800 OOOOOOOE 

00000000 34030330 E240000O OOOEFFOO 8AF00OO0 00000400 

00000962 30008AFO 08000000 O0OE07OF 20003000 09620000 

OOOOOOOE FF008AF0 00303030 04000000 O00E07OC 20000000 

OOOOOOOE 370F2000 00300962 00000000 04000000 00000000 




























































































^^^^^^&u£i^L 



















v> 



An example of an I/O trace executed in core-wrap output mode in the PD area. The 
PD area was dumped using the DUMP command. 



2.44 Serviceability Aids. 



o 



Fetch /Load trace 

The F/L (fetch/load) trace records the order in which phases and transients are 
called from the core image library under the control of DOS/VS. Issuing a fetch 
or load causes an SVC 1 , 2 or 4, and the format of data recorded is as follows: 

Length of one entry = 22 decimal bytes 



Trace Routines 

PDAIDS 



PHASE NAME 

I I I I I 



SVC 

No. 



SVCADDR 



~~l 1 T~ 

LOAD ADDR 

L_J L_ 



— T — i — r— 

ENTRY ADDR 

I 1 1 



JYSLOG 

!5_ 



_X_ 



AR.BG, F4, F3, F2, F1 
See note 4. 



.Entry address to give 
control to the phase. 




Address at which 
the phase is loaded. 



Call Address (This is taken from 
the SVC old PSW; therefore it is 
actually 2 bytes past the calling 
address.) 



■Value of the Supervisor Call (See note 3) 



Phase Name 



o 



Notes: 

1. At times, SVC 5, 6, 11, and 14 branch directly into the supervisor fetch or 
load routine. These are traced whenever they occur, and appear in the 
output of the trace; however, the calling address and SVC values do not 
indicate the actual fetch or load. 

2. Use of the REQ UEST key during the operation of the F/L trace may result 
in apparently erroneous data due to the supervisor action required to 
handle the request. 

In particular, supervisor calls that have already been recorded may not be 
completed, and part of the data put out by the specific phase may pertain 
to these incomplete SVCs. 

3. A list DOS/ VS S VCs can be found in Section 4. 

4. The SYSLOG ID is described in appendix B. 

When the data is recorded in the PD area, either in a trace table or, when using the 
core-wrap output mode, in a rotating buffer, the two bytes used for the SYSLOG ID 
is recorded between SVC ADDR and the LOAD ADDR. 



Serviceability Aids. 2.45 



Trace Routines 

PDAIDS 



On the occurrence of an event, an entry is generated. By selection of the trace 
output device, the event can be: 



Recorded on magnetic tape 
Printed on a line printer 
Preserved in the PD area 
Preserved in an alternate area. 



When magnetic tape output is used, the tape must be processed by the PDLIST 
utility program to provide a formatted output on a line printer. 

The modes of output and PDLIST are described under B-l in this Section. 

Tracing Options: The F/L trace functions are: 

• Trace all SVC 1,2,4, and certain SVC 5,6,11, and 14 interruptions. 

• Limit the trace by partition (multiprogramming systems only). 

Trace limiting options are specified by the initializer keyword TRACE PARTITION= 

These options are useful only when the user runs several partitions at once, and does 
not wish to trace all of them. If only one partition is operating at a given time, the 
default (trace all partitions) allows both the single partition and the supervisor to 
be traced. 

When to use: Use the F/L trace if you are not certain which phases are required 
for a particular program, or in which sequence they are called by the program. 
From the trace output you can see where the phases were loaded and their 
entry addresses. In addition you can check the logical use of the phases for the 
program. 

The next two examples show the output obtained from an F/L trace. 






2.46 Serviceability Aids. 



"~^ 



Trace Routines 

PDAIDS 

















! // JOB POL I ST 




DATE 12/06/73 


CLOCK 20/31/54 






• ] // ASSGN SVS005.X'2A1« 

// HTC REWtSYSOOS 
_ ! // EXEC POL I ST 




f/l IrCCO^ (yyt £<f Ja£ 












fc siex. u>A**i p$B0fe/V' 






A | //BCLOSE 2 C-040B4A 
| //BEOJ3 E C-040B4C 


BG L-0082E8 E-O082F0 
BG L-0082E8 E-0082E8 


//BCL0S2 2 C-0084D6 BG L-0082E8 E-0082FO 
//BE0J4 2 C-00837C BG L-0082E8 E-0082F0 








• i //BEOJT 2 C-0084BA 


BG L-0O82E8 E-0082F0 


//BEOJ 2 C-008372 BG L-0082E8 E-0082F0 






_ I //BEOJS1 2 C-00847A 


BG L-0082E8 E-0082F0 


/JOBCTL-A 4 C-00839E BG L-040078 E-041888 








/JOBCTLG 4 C-040958 
• 1 /JOBACCT 4 C-041AE0 


BG L-041888 E-041888 
BG L-041B80 E-041B80 


/JOBCTLN 4 C-040958 BG L-041888 E-041888 
/JOBCTLG 4 C-040958 BG L-041888 E-041888 






_ /JOBCTLF 4 C-040958 
I /JOBCTLJ 4 C-040958 


BG L-041888 £-041888 
BG L-041888 E-041888 


/JOBCTLG 4 C-040958 BG L-041888 E-041888 J 


Ctx 17 Kr) 




1 //BOPEN 2 C-040B42 BG L-0082E8 E-0082FO 1 
















An example showing an F/L trace output as printed on a line printer using 
PDLIST. (A tape unit was selected as output device for the PDAID.) 



o 






-P.D.- 
009480 
0094A0 
0094C0 
0094E0 
009 500 
009 520 
009 540 
009560 
009580 
0095AO 
009 5C0 
0095E0 
009 600 
009620 
009640 
009660 
009680 
0096A0 
009 6C0 
009 6E0 
009700 
009720 
009740 
009760 
009780 
009 7A0 
O097C0 
0097E0 
009800 
009 820 
009 840 
009860 
009 880 
009-8A0 
009 8C0 
0098E0 
009900 
009920 
009940 
009960 
009980 
0099A0 
O099C0 
009 9E0 

L8LTYP 
— c 2~ 

061000 
091020 
081040 



Jo& WlZrHJZ, 



rU 



O0OO03D3 —SAME — 
00000000 00000000 00000000 



Pfi a^eJi (oooo^9F^ oo 



AREA _ _ 

. . .., ^___^^^ 0000479C 

00000000 00006940 00003&T4 00001003 

90ECD202 B0090025 D200B008 008B07FA 

FFFFFF30 FFFFFFFF 07FA070A 07FA070A 

4710909A 95FF90F5 078A95FF 90F5078A 

078A53B0 90EC501B 000C500B 0010D207 

0201B014 80029502 B0084770 90CE4111 

90F04740 90E258B0 90E850BO 90EC07FA 

FFFFFFFF 5B5BC2C5 D6D1F340 OB008908 

F4400200 88860000 87CO0OOO 87C8C6F2 

000087C8 C6F25B5B C2C5D601 F4400200 

0601F540 02008704 OOOO87C0 000087C8 

87CO000O 87C8C6F2 5B5BC2C5 D6D1F540 

C2C5D631 F4400200 881A0000 87C0O000 

000087C0 O00O87C8 C6F25B5B C2C5D6D1 

5B5BC2:5 06D1F540 020087D4 000087CO 

881A00OO 87C00000 87C8C6F2 5B5BC2C5 

C6F25B5B C2C5D601 F4400200 881AOO00 

02008996 000087C0 OO0087C8 C6F25B5B 

87C8C6F2 5858C2D7 C3C8D240 02008A3E 

D7400200 894 CO000 87C000OQ 87C8C6F2 

000087C8 C6F2 JSB5B C2C404D7 C2C30200 

07C50540 

87COOD30 

C2D6D4E3 

000087C0 

5B5BC236 

89EE0000 

C6F25B5B 

02008*32 

87C8CSF2 

540020B 

000087:8 

04E3FD=5 

87C 00000 

C2C3:536 

000087:0 

5B5BC2:3 

8A020300 

C6F2535B 

020B1732 

87C8C6F2 

FOF 50230 

000087C8 



)00 00000000 00000000 , 



0000168E 
|D7;4C1C9 



FFFFFFFF 
47F09036 
95FF90F5 
B0005000 
0008501B 
00009584 
000087CO 
5B5BC2C5 
881AOO0O 
C6F25B5B 
020087D4 
87C8C6F2 
F4400200 
000087C8 
06D1F540 
87C0O0OO 
C2C5D6D1 
000087CO 
5B5BC2C4 



/ 

y^oooc 

HlFFFF 



0000B44Ef 00000C56 00009F02 
C4C6E3E6JFFFF0009 FFFF58B0 



FFFFFFFF FFFFFFFF FFFFFFFF 

428090F5 58800080 91018042 

078A95FF 90F5078A 95FF90F5 

58800014 4880805A 4A8090F4 

00105818 000C41BB 001659B0 

0000973C 000099FC 0040FFFF 

0O0O87C3 C6F25B5B C2C506D1 

D6D1F540 020087D4 OO0087C0 

87C00000 87C8:6F2 5B5BC2C5 

C2C5D6D1 F4400200 881AO0OO 

000087CO 000087C8 C6F25B5B 

585BC2C5 D6D1F540 020087D4 

881A0000 87COO00O 87C8C6F2 

C6F25B5B C2C5D6D1 F4400200 
020087D4 000087m 




....EEBE0J3 



.HF2EEBE0J4 



.HF2EEBEOJ5 



40400200 885E00 
000087C8 C6F25B 
E4D4D7C2 02008Aft 



88EEOO0O 8 7C000 00 87C.8: 







(22 6y&) r ^ 

000087CO 
5B5BC2D6 

SYSLOfTO 



5BSBL2C3 
12C2O0O0 
C6F25B5B 
020089EE 
87C8C6F2 
E5F1020B 
000087C8 
03D6E2F2 
87COOOO0 
C2C3D3D6 
000087C0 
5B5BC2D6 
89EEO0OO 
C6F25B5B 



D306E2C5 
87C00000 
C2D6D7C9 
000087C0 
5B5BC206 
315A000O 
C6F25B5b 
020089CE 
87C8C6F2 
E2C50200 
000087C8 
07C9C7D5 
87C00000 
C2D607C5 



O2OO8A90 
87C8C6F2 
C7D50400 
O0O087C8 
D7C5D5F1 
87COO000 
C2C3D3D6 
O0OO87C0 
5B5BC2C3 
8A900000 
C6F25B5B 
04008946 
87C8C6F2 
D5F10200 



HEX LENGTH IS 0000 

[D7C8C1E2 C55C5C5C 074D3000 000B1718 
07C8:iE2 A00B16EE 000B32A8 0000001B 
00000330 00000000 00000000 00000000 



D306E2F3 
87COOO0O 

000087C0 000087C8 C6F25B5B C206D7C5 

5B5BC2D6 D7C5D5F1 02008862 000087CO 

89460000 87C00000 87C0C6F2 5B5BC2D6 

C6F25B5B C2D6D7C5 05400200 89220000 

02008862 000087CO 000087C8 C6F25B5B 

87C8C6F2 5B5BC2C3 D4E3F0F1 02008,986 

E2C5020B 17C20000 87C00000 87C8C6F2 

000087C8 C6F25B5B C2C3D3D6 E2F3O20O 

04E3F0F5 02008882 000087C0 000087C8 

87CO0O00 87C8C6F2 5B5BC2D6 D7C5D540 

C2D6D7C5 D5F1O200 88620000 87COOO0O 

000087CO 000087C0 C6F25B5B C206D4E-3 

5B5BC2D6 07C5D540 02008922 000087CO 

88620000 87C00000 87C8C6F2 00000000 



00000000 00000000 400B107A 0003207A 
000B1910 00000049 0O00D002 0000002E 
00008450 5E0E6CAF 00000000 00000000 



...HF2 |E£B0MPBC.. 

PEN H 

HF2£GB0PIGN 

BOHT05 

HF2££B0PE 

t£B3PIGN 

HF2EGBC 

F2££BCL3S2 

....< HF26S 

.HF2££BCL0SE.... 

N ...B HF2 

...HF2EGB0PIGN.. 
NT05 ,....H 



F2ESBE0J 

GEBE0J5 ...M.... 

HF2££BE 

F2££BE0J4 

...» HF2££ 

• HF2SCBEOJ5 ...» 

4 HF2 

...HF2GSBEOJ4 .. 

0J5 ...» H 

HF2EEBEOJ7 

BEOJ 

HF2££BDUM 

££BDUMPB. 



HF2 JS£B0 



F2£EB0PEN1. 

F2££ 

.HF2E6B0PEN .... 

Nl HF2 

,...F2££B0UR01.. 

LOSE H 

HF2££BCL0S3 

3CMT05 

HF2££B0PE 

EEB0PEN1 

F2££B0 

F266BOPEN 

HF2££B0PEN1 HF2££ 

BCEOtfl HF2££BCMT0l. 



.HF2£6BCL0 

E£BCL0S2 

• K HF2GEBC 

F2££BCL0SE 

...< HF2E6 

.HF2EEB0PIGN.... 

05 HF2 

...HF2££B0PEN1.. 



,HF2 
...HF2££BCL0S3.. 

MT05.. H 

HF2££BOPEN 

BOPEN1 

F2EEB0MT 

EEBOPEN 

HF2.... 



PHASE***. 
PHAS 



■ l 



An example showing the PD area in a system dump after executing the F/L trace 
in core-wrap output mode in the PD area. 



Serviceability Aids. 2.47 



Trace Routines 

PDAIDS 



Generalized Supervisor Call trace 

The GSVC trace records SVC interrupts as they occur. All SVCs, or a selected 
group of SVCs, may be traced. The format of the data recorded in the PD area 
either in a trace table or, when using the core -wrap output mode, in a rotating 
buffer, is as follows: 



J) 



Length of one entry = 1 8 decimal bytes 



I I 

SVCOLDPSW 
ill i . I i 


1 1 1 

GR0 
i 1 1 


SVC 
No. 


1 1 
GR1 

I I 


SYSLOG 
ID* 



-*► AR 
BG 
F4 

F3 T 
F2 
F1 



See note 5 



The contents of general purpose register 1 



Value of the Supervisor Call, (See note 3.) 



The contents of general purpose register 0. 



Notes: 

1. IfPTO=YES in the FOPT macro, then SVCs issued when the physical 
transient area is busy are not traced. 

2. The PSW is described in E-2 of this Section. 

3. A list of DOS I VS SVCs can be found in Section 4. 

4. General purpose register usage is described in Section 4. 

5. The SYSLOG ID is described in appendix B. 



o 






2.48 Serviceability Aids. 



o 






Trace Routines 

On the occurrence of an event, an entry is generated. By selection of the trace PDA IDS 

output device, the event can be: 

• Recorded on magnetic tape 

• Printed on a line printer 

• Preserved in the PD area 

• Preserved in an alternate area. 

When the magnetic tape output is used, the tape must be processed by the 
PDLIST utility program to provide a formatted output on a line printer. 

The modes of output and PDLIST are described under B-l in this Section. 

Tracing Options: The GSVC function provides the following options: 

• Trace all SVCs that occur. 

• Trace up to six SVCs selectively. 

• Eliminate up to six SVCs selectively, and trace all others. 

• Trace all partitions. 

• Trace up to five partitions selectively. 

SVC limiting options are specified by the initializer keywords IGNORE SVC= 
or TRACE SVO. All SVC activity is traced if one of these option keywords is 
not specified. The two keywords are mutually exclusive: when one is specified, 
the other becomes invalid. 

The partition limiting options are specified by the initializer keyword TRACE 
PARTITION^ This is useful only when the user must run several partitions at 
once, and does not wish to trace all of them. 

When reading the output from this trace routine you may see more SVCs listed 
than expected. This is because an SVC already traced and recorded may be reset by 
the supervisor SVC routine, and then re-issued by the program being traced. For 
example, your program may issue an SVC 0, which is traced. But the channel 
queue may be full at that point in time, and so the supervisor can not handle the 
SVC 0. When your program has control again it will issue the SVC which will of 
course be traced again. 

When to use: Use the GSVC trace when a particular SVC issued by a troublesome 
program is suspected of causing the errors. 

The values of registers and 1 are printed on the trace output and these can be 
important for certain SVCs. 

The trace output also shows the current PSW at the time the SVC was issued. 
Therefore, the instruction and routine issuing the SVC in the program can be 
located. 

The next two examples show the output obtained from a GSVC trace. 




Serviceability Aids. 2.49 



Trace Routines 

PDAIDS 



// ASSGN SYS005,X«2Al' c 

It MTC REW.SYS005 /// zv , r /* ^ blfCO 

II EXEC PDLIST ^-SVC M fSW . 9«? ^^^ ^^ . 

PSW^070010000000 837i| / 0^000092COll^0092CO|^0^^ :: B$)| pSW-071D2000000»OB'VA 0-000406*4 1-000*1508 N-02 T-BG 
PSW-070D10000000831C 0-000*OB*4 1-00000*AO N-21 T-BG PSW-070D000000008*84 0-000*06** 1-000*1*88 N-1A T-BG 
PSW-0700000000008*D6 0-000*08** 1-000082E8 N-02 T-BG | PSW-070000000000830* 0-000*06** 1-00000*A0 N-21 T-BG 1 



PSW-0700000000008422 0-000*06** 1-00000*AO N-OB T-BG PSW-071D2000000*OB*C 0-000*06** 1-000*1*88 N-OE T-BG 
PSW-O70DOO0O000082FC 0-000*0B** 1-00000*AO N-21 T-BG PSH-070000000000837C 0-000*06** 1-000082E8 N-02 T-BG 
PSW-0700000000008306 0-000*08** 1-00000*AO N-21 T-BG PSW-070D2000000084BA 0-000*06*0 1-000082E8 N-02 T-BG 



'One. facx. 



An example showing a GSVC trace output as printed on a line printer using PDLIST. 
(A tape unit was selected as output device for the PDAID.) 



03F980 

03F9A0 

03F9C0 

03F9E0 

03FA00 

03FA20 

03FA40 

03FA60 

03FA80 

03FAA0 

03FAC0 

O3FAE0 

O3FBO0 

03FB20 

03FB40 

03FB60 

03FB80 

03FBA0 

03FBC0 

03FBEO 

O3FC00 

03FC20 

03FC*0 

03FC60 

03FC80 

03FCAO 

03FCCO 

03FCE0 

03F000 

03FD20 

03FD*0 

03FD60 

03F080 

03F0A0 

03FDC0 

03F0E0 

03FE00 

03FE20 

03FE*0 

03FE60 

03FE80 

03FEAO 

OMSCO- 

03FEE0 

03FF0O 

03FF20 

03FF40 

03FF60 

03FF80 

03FFA0 

03FFCO 

03FFE0 



TERMTOMS 

22560000 
0000000* 
C2C70710 
000*0808 
000*0CA9 
000*22EE 
071D3000 
0910C2C7 
000B070* 
220C0000 
0000000* 
C2C7071D 
070*0808 
000*OCA9 
000*2256 
07100000 
0820C2C7 
OCA9000* 
22C*0000 
OOOOOOO* 
C2C7071D 
000*0910 
000000 IB 
0O0*22EE 
07100000 
08D8C2C7 
OCA9000* 
22*C0OO* 
3000000* 
C2C70710 
070*0910 
OOOOOOOB 
0OO*22C* 
O71DO0OO 
0910C2C7 
001B000* 
22560000 
OOOOOOO* 
C2C7071D 
000*0808 
000*OCA9 
000*22EE 
07403000 
0910C2C7 
000B070* 
22OCO00O 
OOOOOOO* 
C2C70710 
070*0808 
000*0CA9 
000*201 A 
00000000 



001B070* 
2256000* 
OOOOOOO* 
C2C70710 
000*0910 
OOOOOOOB 
000*2202 
07103000 
0910C2C7 
OOOB070* 
22E80000 
3000000* 
C2C7071D 
070*0808 
000*0CA9 
000*2256 
07100000 
0910C2C7 
OOOB070* 
22OCOOO0 
OOOOOOO* 
C2C7071D 
000*0910 
OOOOOOIB 
000*2256 
07100000 
08D8C2C7 
OCA 90 00* 
2202000* 
3000000* 
C2C70710 
070*0910 
OOOOOOOB 
000*22DC 
07100000 
0910C2C7 
001B070* 
2256000* 
OOOOOOO* 
C2C70710 
000*0910 
OOOOOOOB 
-00042,202 
07103000 
0910C2C7 
0O0B070* 
22 E 80000 
3000000* 
C2C7071D 
070*0808 
00040CA9 
00000000 



12/06/73 

08D8C2C7 
0CA9070* 
2256000* 
OOOOOOO* 
C2C70710 
000*0910 
OOOOOOOB 
000*22EE 



071D1000 
08D8C2C7 
0CA9070* 
2256000* 
OOOOOOO* 
C2C7071D 
000*0910 
OOOOOOOB 
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107103000 OO0*22D2~ 



000*22*C 000*0CA9 000408D8 C2C70710 
07101000 0004224C 00040CA9 000*08D8 
08D8C2C7 07101000 000*22*C 00040CA9 
0CA907O* 0808C2C7 0710300^ "•"" •»? — 
22OC000* 0CA9070* 0910C2C £>rtg ifmXs 
OOOOOOO* 22C*0000 000B07C/ >- ' 

C2C7071D OOOOOOO* 22DCOOCf Vn**ty> 
000*0910 C2C7071D QOaflflTO* 22C40000 



.QBG., 
....BG. 



"W- 



2, 



SVC o4/fSW 



C2CT0flU 

070*0808 

000*OCA9 

000*201A 

07103000 

0910C2C7 

0O0B070* 

22C*0000 

OOOOOOO* 

C2C70710 

000*0910 

OOOOOOIB 

000*2256 

07100000 

08D8C2C7 

0CA9000- 

22EE0000' 

3000000* 

C2C 70710 

070*0910 

OOOOOOOB 

000*2 2E 8 

07103000 

08D8C2C7 

0CA9070* 

2256000* 

OOOOOOO* 

C2C70710 

000*0910 

OOOOOOOB 

000*22EE 

07103000 

0910C2C7 

001B0704 

224C0000 

10000004 

C2C7071D 

07040820 

00000000 



SVCO' 



1UUUUUU1 
C2C7071D 
07040808 
0004 0CA9 
000422EE 
071D3000 
0910C2C7 
OOOB070* 
22OC0000 
OOOOOOO* 
C2C7071D 
070*0808 
000*0CA9 
000*2256 



0001B 000*0910 
42256 OOOOOOIB 
SySLOC, ID 00000 00042256 
2<*i.uuuh. iA.iiuwi uoJ8C2C7 07100000 
OOOOOOO* 22*C000* OCA9000* 0808C2C7 
C2C7071D OOOOOOO* 2010000* 0CA9000* 
070*0820 C2C7071D 3000000* 22D2000* 
OOOOOOOB 000*0910 C2C7071D OOOOOOO* 
000*2202 OOOOOOOB 000*0910 C2C70710 
071D3000 000*22EE OOOOOOOB 000*0910 
0910C2C7 071D3000 000422D2 OOOOOOOB 
00080704 0910C2C7 071D3000 000422EE 
22E80000 001B0704 0910C2C7 07103000 
30000004 224C0000 001B0004 08D8C2C7 
C2C70710 10000004 224C000* OCA90004 
070408D8 C2C7071D 10000004 224C0004 
00040CA9 070*0808 &aC7071D 10000 00* 
000*2256 000*OCA9 (070*0808 C2C7P 71D 
07100 " 



BG. 



..QBG. 
QBG 



..BG. 
.«s«..QBG 



.QBG. 
...QBG. 



22020000 0008000" £■*£*' 4&*&<&i2& -fy S ^ C 7 ' 

3000000* 22EE0001 « V V 

C2C7071D 3000000* 22020000 OOOBOOO* 091.0T2C7 

070*0910 C2C70710 3000000* 22EEO000 0016000* 

OOOOOOIB 070*0910 C2C70710 3000000* 22EE00OO 

000*22*C OOOOOOIB 000408D8 C2C70710 00000004 

07100000 0004224C 00040CA9 00040808 C2C7071D QBG... 

0808C2C7 071D1000 0004224C 00040CA9 000*0808 .QBG 

0CA9070* 0808C2C7 07101000 000*22*C 000*0CA9 

2256000* 0CA9070* 0808C2C7 071D3000 000*2202 

OOOOOOO* 22DC000* 0CA90704 0910C2C7 07103000 

C2C7071D OOOOOOO* 22C40000 0OOBO70* 0910C2C7 

000*0910 -C2C70710 OOOOOOO*- 22DC0OO0 0008070* 

OOOOOOOB 000*0910 C2C7071D OOOOOOO* 22C40000 

000*2202 OOOOOOOB 000*0910 C2C70710 OOOOOOO* 

07103000 000*22EE OOOOOOIB 000*0910 C2C70710 

0910C2C7 07103000 000*22EE OOOOOOIB 000*0910 

0018000* 08D8C2C7 07100000 000*2256 OOOOOOIB 

22*C000* OCA9000* 08D8C2C7 07100000 000*2256 ...QBG 

OOOOOOO* 2010000* 0CA9000* 0820C2C7 07100000 .......QBG. 

C2C7071D OOOOOOO* 224C000* OCA9000* 08D8C2C7 

00000000 00000000 
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An example showing a GSVC trace in core-wrap output in an alternate area. The 
alternate area is dumped on termination of PDAID and is given back to the main 
page pool. (The beginning of the alternate area is not shown). 



v> 



2.50 Serviceability Aids. 



QTAM Trace 



Trace Routines 

PDAIDS 



If 






This trace records the sequence of SIO instructions issued to channels and devices. 
The data recorded is similar to that of the I/O trace, but gives more details about 
the type of I/O interrupt. 

This routine is designed to trace programs running in real mode. However, it can be 
used to trace virtual mode programs provided the following is considered when 
reading the trace output: 

• If the program being traced is running in real mode the CCB address and the 
CCW address in the CSW are real addresses. 

• If the program being traced is running in virtual mode, the CCB address and 
the CCW address in the CSW are, respectively, the address of the CCB copy 
block. (Refer to Section 4 Chapter 13 for a description of CCB and CCW 
copy blocks.) 

There are three types of trace events and each type is recorded, having a prefix 
that defines the type. 

The data is recorded in the PD area, either in a trace table or, when using the 
core-wrap mode of output, in a rotating buffer. The format of the data recorded 
is as follows: 

• On the occurrence of an SVC interrupt; 



SVC 
No. 



1 I I I I T 

SVC OLD PSW 
J I ! I ! _L 



GR0 
J I i 



i — r 



GR1 
J L_ 



ISYSLOq 
ID 



Prefix V 
X'E5' 



AR 
BG 
F4 
F3 
F2 
F1 



- (See note 5.) 



• General purpose register 1 
General purpose register 



(See note 4) 



Value of the Supervisor Call (See note 2.) 



• On the occurrence of an SIO instruction 

~l — I — I — r— 
CSW 
_J I I I I ! L 



~l — I r- 

CCB ADDR 
_J I L_ 



1 T 



i 1 i 1 

FF FF FF FF FF 
_J L_J L_ 



Device 
Addr 



Prefix S 
X'E3' 



Condition code 



Not used 



o 



• 


On the occurrence of an I/O interrupt; 






1 


Device 
Addr 


I I 1 1 1 l 1 

I/O OLD PSW 
I i i l 1 i 1 


1 1 1 1 1 1 1 

CSW 
1 I 1 i l 1 l 


1 
FF FF 








' 


1 
Mot usee 



Prefix I 
X'C9' 

Notes: 

1. The PSW and CSW is described in E-2 of this Section. 

2. A list ofDOS/VSSVCs can be found in Section 4. 

3. The CCB is described in Section 4. 

4. General purpose register usage is described in Section 4 

5. The S YSLOG ID is described in appendix B. 

Any of these occurrences is referred to as an event. On the occurrence of an 
event, an entry is generated. 



Serviceability Aids. 2.51 



Trace Routines 

PDAIDS 



By the selection of the trace output device, the event can be: 

• Recorded on magnetic tape 

• Preserved in the PD area 

• Preserved in an alternate area. 

When magnetic tape output is used, the tape must be processed by the PDLIST 
utility program to provide a formatted output on a line printer. 

The modes of output and PDLIST are described under B-l in this Section. 

Tracing Options: The QTAM trace function provides the following options: 

• Trace all SVC and 3 1 , SIO , and t/O interrupts . 

• Trace SVC and 31 , SIO, and I/O interrupts from any three devices. 

• Ignore SVC and 31 , SIO, and I/O interrupts from and three devices. 

• Trace in all partitions 

• Selectively trace up to five partitions. 

Trace limiting options are specified by the initializer message parameters 
IGNORE DEVICE^ or TRACE DEVICE=. (The device options are invoked by 
specifying the three devices to be traced or ignored.) All SVC and 31 , SIO, 
and I/O interrupt activity is traced in all partitions of core if one of these 
options is not specified. They are mutually exclusive: when one is specified, the 
other becomes invalid. 

The partition limiting options are specified by the initializer keyword TRACE 
PARTITION^ 

When to use: Use the QTAM trace to check the sequence of SIO instructions 
to the channels and devices. Use this trace if you suspect errors in I/O interrupt 
handling routines or in program routines issuing SVC and SVC 31 , or if you 
suspect errors in the sequence of I/O interrupts being returned from channels 
or devices. The next two illustrations are examples of output from a QTAM 
trace. 

The next example shows a dump of the real address area containing trace output 
when the core-wrap output mode in an alternate area is selected. 



if T\ 



2.52 Serviceability Aids. 



Trace Routines 

PDAIDS 



TERMKEN 



12/06/73 



GR 0-7 80040B0C 00041500 0003F800 00000000 

GR 8-F B00400A4 900*1086 00000000 182F07F1 

FP REG 00000000 00000000 00000000 00000000 

CR 0-7 004000FF OOOOE640 FFFFFFFF FFFFFFFF 

CR 8-F O000FFFF 00000000 00000000 00000000 






.if 



o 



00000050 00041084 
00040078 40040084 
00000000 00000000 
00000000 00000000 
00000000 00000000 



00042084 00040FB8 
0OO3FFF5 08041518 
00000000 00000000 
00000000 00000000 
C2000000 00000200 



03F800 
03F820 
03F840 
03F860 
03F880 
03F8A0 
03F8C0 
03F8E0 
03F900 
03F920 
03F940 
03F960 
03F980 
03F9A0 
03F9C0 
03F9E0 
03FA0fl_ 
-05FA20 
03FA40 
03FA60 
03FA80 
03FAA0 
03FACO 
03FAE0 
03FB0O 
03FB20 
03FB40 
03FB60 
03FB80 
03FBA0 
03FBCO 
03FBE0 
03FC00 
03FC20 
03FC40 
03FC60 
03FC80 
03FCA0 
03FCC0 
03FCE0 
03FD00 
03F020 
03FD40 
03F060 
03FD80 
03FDAO 
03FDC0 
03FDE0 



FOOCOOOO 
0130070F 
04000000 
09070F20 
OOOOOOFF 
070F20OO 
OOOOFFFF 
OF200000 
OOFFFFFF 
20000000 
FFFFFFFF 
00000009 
FFFFFFFF 
A01000E7 
00FFFFC9 
_0Q& 



0F200000 
OOFFFFFF 
20000000 
FFFFFFFF 
00000009 
FFFFFFFF 
0000090C 
FFFFFFC9 
00090C00 
FFFFC900 
090COOOO 
FFC90009 
OCOOOOOO 
C9000907 
60084000 
0130070F 
04000000 



00090C00 
FFFFC901 
090C000O 
FFC90130 
OCOOOOOO 
C9000907 
00000000 
00090 70F 
00000004 
09070F20 
00000400 
070F2000 
00040000 
OF200000 
50FFFFFF 
20000000 
FFFFFFFF 



003AF00C 
30070C20 
00000400 
070F2000 
00040000 
OF200000 
04000000 
20000000 
OOOOOOFF 
00000009 
OOOOFFFF 
0000090C 
00FFFFE2 
00090C10 
FFFFC901 
090C0O00 
FFC90130 



OOOOOOFF 



00000009 
OOOOFFFF 
0000090C 
00FFFFE2 
00090C10 
FFFFE200 
090C1000 
FFE20000 
OC 1000 76 
E2 000009 
100076C8 
00000900 
00E76008 
30070C20 
00000400 
070F2000 



JJFJE20001 
0CO00O3A 
E2000130 
0OOO87A0 
00000900 
0078D008 
00090000 
79380800 
09000076 
60080000 
000076C8 
08400000 
00E6C800 
400050FF 
00000009 
OOOOFFFF 
0000090C 



FFF 

09OC0DO0 

FFE20001 

OC 00008 7 

C9013007 

00000000 

0009070F 

O03AF0OC 

30070F20 

OOOOOOFF 

070F2000 

OOOOFFFF 

000039AO 

08000000 

0039AOOO 

OOOOOOFF 

00000009 

FFFFFFFF 

0000090C 

FFFFFFC9 

000087AO 

FFFFC901 

00000004 

FFE20001 

OC000087 

E20002A2 

0O0OE838 

O130070F 

OCOOOOOO 

01300000 

3AF00C00 



DO 01300000 



3AC00800 
30000039 
AOOCOOOO 
OC200000 
04000000 
20000000 
OOOOOOFF 
00000009 
FFFFfFFF 
0000090C 
FFFFFFC9 
000087A0 
FFFFC901 
00000004 
FFE20001 
0C00003A 
C9013007 
OOOOOOOO 
0130070F 
OCOOOOOO 
30070F20 
OOOOOOFF 
30000039 
AOOCOOOO 
0000E6C8 
0C000012 
20000000 
FFFFFFFF 
39A00000 
OOOOFFFF 



39A00O0O 

"OT556TFTF 

AOOOOOOO 
00FFFFE2 
00090C00 
FFFFE200 
090COOOO 
FFE20001 
0C00003A 
C9013007 
OOOOOOOO 
01300 70F 
OCOOOOOO 
30070F20 
OOOOOOFF 
30000039 
FOOCOOOO 
OC200000 
04000000 
20000000 
FFFFFFFF 
00000009 
FFFFFFFF 
AOOOO OM- 

ooFFFifyT 

000087*01 
FFFFE200 
O90C0000 
FFC90130 
87A00C00 
E2000130 



3AF00C00 
C9013007 
00040000 
00013000 
003AC008 
01300000 
00000400 
30000039 
FOOCOOOO 
0C2 00000 
04000000 
20000000 
FFFFFFFF 
00000009 
FFFFFFFF 
A000003A 
00FFFFE2 
00090COO 
FFFFE200 
O9OCO000 
FFC 90130 
OCOOOOOO 
C9013007 



OOOOFFFF FFFFFFK9 



0F2O0O0O 
OOFFFFFF 
0039A000 
OOOOOOFF 
39A0000O 
OOOOFFFF 
A000003A 
0OFFFFE2 
00090COO 
FFFFE200 
090C0000 
FFC90130 
OCOOOOOO 
C9013007 
FOOCOOOO 
00013000 
003AC008 
01300000 
87AOOCO0 
070C2000 
00040000 
0F2OO000 
OOFFFFFF" 



00090COO 
FFFFC901 
0087AOOC 
FFC90130 
00000400 
C9013007 
FOOCOOOO 
00013000 
003AC008 
01300000 
87A0OC0O 
070C2000 
00040000 
0F200000 
OOFFFFFF 
0039A000 
OOOOOOFF 
39A0O0OO 
OOOOFFFF 
0000090C 
0OFFFFE2 
00090C00 
T*f«C901 



30000039 
C0080000 
000039AO 
OCOOOOOO 
00780000 
OOOOOOFF 
79380000 
OOOOFFFF 
60000000 
00FFFFC9 
OOOOOOOO 
FFFFC900 
00000004 
FFE20001 
OC00003A 
E2000130 
00003AF0 
0130070C 
00000004 
30070F20 
OOOOOOFF 
070F2000 
OOOOFFFF 
OF200000 
OOFFFFFF 
0039A000 
OOOOOOFF 
39AOOOO0 
OOOOFFFF 
0000090C 
00FFFFE2 
00090COO 
FFFFC901 
003AFOOC 
FFC90130 
00000400 
E2000130 
00003ACO 
00013000 
003AF00C 
30070F20 



A000003A 
O0FFFFC9 
OOOOOOOO 
FFFFC900 
00000004 
FFC90009 
00000400 
C9000907 
00040000 
0009070F 
04000000 
09070F20 
OOOOOOFF 
30000039 
C0080000 
OOOO39A0 
OCOOOOOO 
20000000 
OOOOOOFF 
00000009 
FFFFFFFF 
0000090C 
FFFFFFC9 
00090COO 
FFFFC901 
003AFOOC 
FFC90130 
00000400 
E2000130 
00003AC0 
00013000 
0O3AF0OC 
30070F20 
OOOOOOFF 
070F2000 
OOOOFFFF 
0O0039A0 
08000000 
0O39A0OO 
OOOOOOFF 
00000 



OOOOOOOO 



svco 



SVC <&/>sv 



fate, envy/ 
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TERMKEN 




12/06/73 












03FE00 


070F2000 


0000090C 


000087AO 


OCOOOOOO 


FFFFE200 


01300000 


39A00OOO 


87A00C00 


03FE20 


OOOOFFFF 


FFFFFFC9 


0130070F 


20000000 


O9OCOO0O 


3AF00C00 


OOOOFFFF 


E2000130 


03FE40 


000039AO 


00003AFO 


OCOOOOOO 


FFFFFFFF 


FFC90130 


070F2000 


0000090C 


000087A0 


03FE60 


OCOOOOOO 


FFFFE500 


00071000 


00000415 


42A00410 


6C000414 


88C2C7E2 


0002A200 


03FE80 


OOE6C800 


0087A00C 


OOOOOOFF 


FFFFFFFF 


C902A207 


OF200000 


00090C10 


00E8380C 


03FEA0 


000001FF 


FFE50000 


071D0000 


00041542 


A004106C 


00041488 


C2C7E200 


02A20000 


03FECO 


E6C81000 


E8380C00 


0001FFFF 


FFFFFFC9 


02A2070F 


20000000 


090C1000 


E7600C00 


03FEEO 


0001FFFF 


E5O0O007 


1DOO0000 


041542A0 


04106C00 


041488C2 


C7E20002 


A20000E6 


03FF00 


C81000E7 


600COOOO 


01FFFFFF 


FFFFC902 


A2070F20 


00000009 


0C1O00E8 


380C000O 


03FF20 


01FFFFE2 


00013000 


0039A010 


00E8380C 


000001FF 


FFFFFFFF 


C9013007 


OF200000 


03FF40 


0009 OCOO 


003AFOOC 


OOOOOOFF 


FFE20001 


30000039 


A000003A 


FOOCOOOO 


OOFFFFFF 


03FF60 


FFFFC901 


30070F20 


00000009 


OC00003A 


FOOCOOOO 


00FFFFE2 


00013000 


0039AOOO 


03FF80 


003AF00C 


OOOOOOFF 


FFFFFFFF 


C9013007 


0F200000 


00090COO 


003AFOOC 


OOOOOOFF 


03FFAO 


FFE20001 


30000039 


A000O03A 


FOOCOOOO 


OOFFFFFF 


FFFFC901 


30O7OF20 


00000009 


03FFC0 


0C00003A 


FOOCOOOO 


00FFFFE2 


00013000 


0039A000 


O03AFO0C 


OOOOOOFF 


FFFFFFFF 


03FFE0 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 
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An example showing a dump of the alternate area used for a QTAM trace in core- 
wrap output mode. 
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016900 
016920 
016940 
015960 
015980 
016940 
0169C0 
0159E0 
O16A0O 
016420 
0164*0 
016460 
016480 
015A40 
0164CO 
016AE0 
016B00 
016B20 
016840 
016B60 
016B80 
016B40 
0168C0 
0163EO 
O16C0O 
016FE0 

-P.O.- 
009480 
009440 
0094C0 
00J4E0 
009500 
009520 
009 540 
009560 
009580 
009 54 
0095C0 
0095 c 
009600 
009620 
009640 
0)9660 
009680 
009 64 
0096C0 
0096E0 
009 700 
009720 
009 740 

ooggco 

LBLTYP 
— 3G— 
043000 
040020 
040040 
040060 
040180 
0400AO 



0OOOO00E 
831 0;2:7 

eeeeoi:s 

00000008 
00000300 
00020303 

8310:2:7 
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The example above shows part of a system dump output. By examination of the 
PDAREA printed in the dump (when PDA ID is supported by the system) it can 
be seen that a QTAM trace was active when the dump was executed. From the 
PDAID phase name in the PD area, the output mode for the trace was core-wrap. 
However, no trace entries are seen in the PD area, which indicates that the an 
alternate area had been specified for the trace entries. The start address of the 
alternate area is contained at displacement decimal 20 from the start of the PD 
standard preface table. (The standard preface table starts at the PDAID 
phase name.) 
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This example shows part of a system dump output that by examination of the PD 
area indicates QTAM trace entries in the PD area. Compare this example with the 
previous one and note the difference between the information contained in the 
PD area. 
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The PD area 

The PD area is located in the supervisor and consists of four separate parts 
described below and shown in 

1. PD Address Table 

This table is built up during system generation if the system is to support 
PDAIDS. It contains the addresses of the supervisor hooks that provide the 
interface between the PDAID routines and the supervisor. 

2. PD Standard Preface Table 

This table is built up by the PDAID initializing phase, and is used by the PDAID 
event handling routines. 

3. PDAID Event Handling Area 

This area is occupied by the PDAID event handling routines specified by the 
type of trace requested by the operator. 

4. PD Buffer Area. 

This area is used in the following two ways: 

When core-wrap output mode in the PD area is specified it is used as a rotating 
buffer which preserves events (trace entries). PDAID event handling routines 
use this area as temporary storage for events. This storage area is called the 
trace table. Data is transferred from this table to an output area, which is either 
printed out or dumped on a tape unit, depending on the output device selected 
for the trace routine. 



Locating the PD area 

The start address of the PD area can be located by: 

1. Using any dump containing the supervisor area to find the address of SYSCOM 
(system communication region) in bytes 80 to 83 of low address storage. (See 
E-2 in this Section.) 

The address contained in bytes X'48' to '4B' (label PDARPTR) of SYSCOM 
contains the address of the PD area. 

2. Using the supervisor listings to find the address of the label PDAREA. This 
label is the name given to the first byte of the PD area. 

Dumping the PD area 

The easiest method is to use the PD AREA operand of the DUMP command. (See 
A-l in this Section.) Alternatively, any dump of real storage that includes the 
supervisor area will also include the PD area. 
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Preface Table 
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NEXT 


WRAPADR 




PD Buffer. 
Used for core-wrap 
output, or PDAID 
event handling. 



For details of 
contents, see 
Appendix A. 
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'Last 12 bytes in PD 
Event Handling Area 



PD buffer, when 
used as core-wrap 
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FIRST entry. 



NEXT entry, 



LAST entry, 



Note: 

See Section 4 for details about the supervisor organization. 



SLOT1 



NEXT 



WRAPADR 



Trace type. 



Contains address of 

FIRST entry in PD 

Buffer. 

It is found at: 



Contains address of 
NEXT available entry 
in PD Buffer. 
It is found at: 



Contains address of 

LAST entry in PD 

Buffer. 

It is found at: 



Length of one 
entry in bytes; 



Maximum number 
of entries in the 
minimum PD area 
of 1400 bytes (dec) 



Input/output 



PDAREA+ 1B4 



PDAREA + 1B8 



PDAREA + 1BC 



18 (dec) 



52 



Fetch/load 



PDAREA + E8 



PDAREA + EC 



PDAREA +F0 



22 (dec) 



52 



GSVC 



PDAREA+X'114' 



B = A +4 



C = A + 8 



18 (dec) 



61 



QTAM 



PDAREA + '1C0' 



B = A+4 



C = A + 8 



21 (dec) 



44 



Notes: 



1. NEXT - address of the next available entry in the PD Buffer. Tfie NEXT entry 
in the PD Buffer contains either the oldest entry in the table, or the most recent 
entry of a device, SVC, or partition being ignored (all entries are placed in the 
NEXT entry before they are checked for trace or ignore). If the latter is the case, 
ignore the entry. 



2. When the LAST entry is filled, the addrcos in SLOT1 is loaded into NEXT and 
the buffer is overwritten by new entries. 



Table B-3 Trace entry locations and lengths for core-wrap output mode in the PD area. 
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Initiating the PDAID trace routines 

You can initiate PDAID trace routines by using standard DOS/VS job control 
languages from either SYSLOG or SYSIPT. The statement 

//EXEC PDAID 

causes the main phase (PDAID) to be loaded at the address of the initiating 
partition. Control is given to the PDAID for further specifications to indicate 
the type of trace to be performed. 

The options and control statements for the trace routines may be entered through 
SYSLOG or through the device assigned to SYSIPT. 

If a card reader is used as SYSIPT, the card deck must be punched as follows: 

Entries may be punched one-per-card, or as multiple entries (separated by commas) 
in a single card. An entry may not be split between two cards. All 80 columns of a 
card may be used, but a card is terminated either by the first blank following an 
entry, or by a GO entry. The last card must be followed by a /* CARD. 

Note: If an incorrect parameter is read from SYSIPT, corrections are requested on 
SYSLOG. 

When the initializing phase (PDAID) has been loaded, the following message is 
issued on SYSLOG: 

4C10DPDAID= 

The operator must respond to this message with one of the following: 

IT Specifies an I/O Trace (See note 1 .) 

FT Specifies an F/L Trace (See note 1 .) 

GT Specifies a GSVC Trace (See note 1.) 

QT Specifies a QTAM Trace (See note 1 .) 

TD Specifies the Transient Dump 

(refer to A-4 in this Section) 

XX Terminates the PDAID presently running 

Pressing the END or ENTER key indicates that PDAID control statements are 
entered through SYSIPT (See note 2.) 

Notes: « 

1. When IT, FT, GT, or QT is specified, the operator must provide additional 
PDAID control statements through SYSLOG. 

2. The END response is valid only for SYSLOG and cannot be used as a SYSIPT 
operand. 

3. Multiple operands or operator responses to PDAID control statements for traces 
with a variable number of functions (such as ignoring SVCs) are not allowed. 
Repeat each parameter with each variable). Repeat each message until either 
the maximum number of variables is reached or an END response is given. 

4. GO terminates the PDAID control input, and the default is taken for any 
PDAID options that are not specified. When you use SYSIPT, GO should be 
the last parameter, and it has no operand associated with it. A /* card must 
follow the GO operand. 
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Selection of an output device: 

The PDAID message/parameter OUTPUT DEVICE= permits the selection of an 
output device. Specify the device by channel and unit, not by symbolic unit. If an 
output device is specified, PDAID checks the address against the supervisor PUB 
and selects the appropriate phase for the unit type (tape or printer). If the output 
is to be magnetic tape, you must use the PDLIST program after tracing is 
complete to obtain a printout of the tape. 

Selection of core-wrap mode: If an output device is not specified, core-wrap mode 
is assumed. The event trace table (see Table B-3) is in the PD buffer in PD area. 
The number of events (trace entries), contained in this area depends on its size as 
generated at system generation time with the option of the FOPT macro. PD=YES 
or 1400 is the minimum, and 10,240 is the maximum that can be selected. 

The table shown in the previous illustration lists the maximum number of events 
that can be preserved in this area, for each of the four trace routines. If core-wrap 
mode is selected, an alternate area can be used. 
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Specifying an Alternate Area 

An alternate area may be specified for core-wrap output through the message/ 
parameter AAA= (alternate area address). AAA= and OUTPUT DEVICE= are 
mutually exclusive: when one is specified, the other cannot be used. The 
operator specifies an alternate area by responding to AAA= with nk. 

n should be an even integer but if an odd integer is specified, n+1 is assumed, 
n specifies the number of thousand (1024) bytes to be allocated to the alternate 
area, which is taken from the main page pool. 

After AAA=nk has been entered, one of four messages is printed on SYSLOG: 

1. If the requested size of the alternate area is accepted, the message is 
4C50E ADDRESS OF AAA= xxxxxx 

2. If space could not be allocated from the main page pool, the message is 

4C52E NO SPACE AVAILABLE FOR AAA. PDAID IS TERMINATED 

The size of the page pool must be increased and the PDAID must be 
re-initialized. 

3. If the space requested is larger than the space that can be allocated from the 
page pool, the message is 

4C51D SIZE OF AAA=nK, ADDRESS OF AAA=XXXXXX. END/CANCEL 

If the space allocated is sufficient, the operator need only press the END/ENTER key. 
However, if the space allocated is not sufficient, the operator must respond 
with CANCEL, and the size of the page pool must be increased before 
re-initializing the PDAID. 



4. If a second or duplicate request is made for an alternate area, or if a request is 
made for a PDAID using an alternate area while any SDAID function is running, 
the second request is automatically terminated, and the message is 4C70E 
4C70E DUPLICATE REQUEST FOR PDAID AND/OR SDAID 
The above message is also issued if a second or duplicate request is made for SDAIDS. 






Dumping the alternate area 

The contents of the alternate area is automatically dumped on the device assigned 
to SYSLST upon termination of the PDAID. (See "Terminating core-wrap in an 
alternate area" for details.) However, if a dump of an alternate area is required 
without terminating the PDAID, use the xxxxxx, xxxxxx operand of the DUMP 
command. (See A-l in this Section for details.) 

Note: If this command is used, the trace output will include the fetch and execute 
of the DUMP transient. Specify the address of AAA in the first operand of the 
command, and calculate the value of the second operand from the value ofnk, 
given in the message 4C51D or specified in the message 4C27D during trace 
initialization. 

Use Table B-3 and the dump to locate the oldest and newest trace entries. 
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Trace Routines 

PDA ID error messages P D A I D S 

PDAID routines issue error messages on SYSLOG if incorrect or duplicate 
parameters are specified, or if selected output devices are not ready. The PDAID error 
messages together with recommended actions for operators and programmers are 
listed in the DOS '/VS Messages manual. 

The following list is a table of options and control statements for executing the 
trace routines. The statements in the table are shown in the sequence in which 
they must be used. Five flowcharts follow the table of options. These flowcharts 
show how to execute the trace routines. 

Six examples of initiating trace routines via SYSIPT, followed by five examples 
of initiating via SYSLOG, immediately follow the last of those flowcharts. 
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Trace Routines 

PDAIDS 
Initializing PDAIDS 



SYS LOG 

Message 



SYSIPT 
Parameter 



PDAID = 



OUTPUT DEVICE 
(see note 3) 



AAA = 
(see note 3) 



TRACE PARTITION= 
(Valid for Fetch/Load, 
SVC, and QTAM Trace) 



IGNORE DEVICE 
(See notes 2 and 7) 



TRACE DEVICE= 
(See notes 2 and 7) 



IGNORE SVC = 
(See notes 2 and 7) 



TRACE SVC = 
(See notes 2 and 7) 



GO (Valid SYSIPT 
Parameter) 
(See note 4) 



SYS LOG 
Response 



SYSIPT 
Operand 



FT 

GT 

IT 

QT 

TD 

XX 

END 



cuu 
X'cuu' 
EN 
GO 







r sp 

BG 

F4 

F3 

F2 

F1 

END 

GO 



"cuu 
X'cuu' 
END 
GO 



cuu 
X'cuu' 
END 
GO 




f~nn 

J END 

l GO 



GO 
(Valid SYSLOG 
Response) 
(See note 4) 



Meaning 



FT - Fetch /Load Trace 
GT - GSVC Trace 
IT- I/O Trace 
QT - QTAM Trace 

TD — Transient Dump, refer to A-4 in this Section 
XX - Terminate present PDAID function. 
END - Additional PDAID control input through 
SYSIPT (See note 5) 



Specify the hexadecimal channel and unit number 
of either a magnetic tape unit or a printer for the 
output device of the PDAID. 
(see note 6) 



The parameter nK specifies the number of bytes to 
be allocated as alternate address area. This area will 
be allocated storage from the main page pool. The 
value n must be an even integer. If it is not an even 
integer, (n+1 ) K is allocated. 



SP - Supervisor 
BG -Background 
F4 - Foreground 4 
F3- Foreground 3 
F2 - Foreground 2 
F1 - Foreground 1 
(see note) 



Specify the hexadecimal channel and unit number 
of the device to be ignored by the I/O and QTAM 
trace. A maximum of 3 may be specified. 



Specify the hexadecimal channel and unit number 
of the device to be traced by the I/O and QTAM 
trace. A maximum of 3 may be specified. 



Specify the hexadecimal SVC number to be ignored 
by the GSVC trace. A maximum of 6 may be 
specified. 



Specify the hexadecimal SVC number to be traced 
by the GSVC trace. A maximum of 6 may be 
specified. 



GO terminates the PDAID control input and the 
default is used for those options that are not 
specified. 



Default 



None. 



Core-wrap mode. 
(See note 7) 



Core-wrap 
mode using 
PD area 



Trace all partitions and 
the supervisor. 



Trace all devices. 



Trace all devices. 



Trace all SVCs. 



Trace all SVCs. 



None. 



Notes: 1. Specification of F1 or F2 is valid for MPS supervisor only. Only SVCs and 31 are recorded for the QTAM trace. 

2. The trace and ignore options are mutually exclusive. 

3. The output device and AAA options are mutually exclusive. 

4. GO will generate default parameters. 

5. END means 'Press the END key', or for Models 1 15, 125, and 158 press the ENTER key. 

6. A magnetic tape unit is the only valid output device for the QTAM trace. 

7. Not applicable to the Transient dump. 

Table B-4 Options and control statements for executing the PDAID trace routines. 

Six examples of initiating trace routines via SYSIPT, followed by five examples of initiating via SYSLOG, immediately follow 
the last of those flowcharts. 
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Trace Routines 



Operator's 
flowcharts 



//JOB PDTRACE 
//EXECPDAID 



4C10DPDAID= 



Enter XX 
and press 
END key 



Select a 

trace 

function 



Press 
END 
only 



Trace events 
specified by 
the function. 



Terminate present, 
trace routine. 



Read parameters 
from SYSIPT. 



Begin selected trace 



4C11D OUTPUT DEVICE^ 



Enter GO 
and press 
END key 



Press END 
key 



Specify an 
output device 
X'cuu' 



o 



4C27D AAA= 



Enter GO 
and press 
END key. 



or 



Specify a 
value for 
alternate area 



Press 
END 
only 



One of four 
messages is issued 



Assume core 
wrap output 
mode with 
default parameters 



Log trace in 
specified alternate 
area 




o 



To part 2, 3, 
4 and 5 



To part 2 To part 3 To part 4 To part 5 



PDAIDS 
Initializing PDAIDS part 1 of 5 



IT - I/O Trace 

FT- Fetch /Load Trace 

GT-GSVC Trace 

QT- QTAM Trace 

TD - Transient Dump (A-4-F) 




Specify the hexadecimal channel 
and unit number of either a 
magnetic tape unit or a printer 
for the output device of the 
PDAID. 

Note: A magnetic tape unit is the 
only valid output device for the 
QTAM trace. 

' Specify the number of bytes 
allocated to an alternate area. The 
■_^ value must be an even integer, 
otherwise the next higher even 
integer is used. 



For a description of these 
messages and required operator 
responses, see 
Specifying an Alternate Area. 

For an I/O, F/L, or GSVC trace 
the device is a line printer or 
magnetic tape unit. For a QTAM 
trace the device may only be a 
magnetic tape unit. 



B-4-F 
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PDAIDS 

Initializing PDAIDS part 2 of 5 



From part 1 



From part 1 




4C13D IGNORE DEVICE 



Specify the hexadecimal channel and 
unit number of the device to be 
ignored (X'CUU') and press END key. 
A maximum of 3 may be specified. 



Note 

The trace and ignore options are 

mutually exclusive. 

Specify the hexadecimal channel and 
unit number of the device to be 
traced (X'CUU') and press END key. 
A maximum of 3 may be specified. 



Select 
device (s) 
to be ignored 



Press 
END 
key 



Enter 
GO 



4C14D TRACE DEVICE = 



Select 
device (s) 
to be traced 



Ignore these 
devices 
(Maximum of 3) 



Press 
END 
only 



Enter GO 
and press 
END 



Trace only 
these devices 
(Maximum of 3) 



Assume that all 
devices are to 
be traced 






Begin trace routine 



Store I/O events 
in the PD area or 
an alternate area 



Display I/O events, 
by 'dumping' 




//EXECPDAID 

PDAID=XX 

/* 

// ASSGN SYS005,X'cuu' 

// MTC REW,SYS005 

//EXECPDLIST 

/* 

/& 



I 



Display I/O events 
using this utility 
program 



Display I/O events 
as they occur 



o 
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PDAIDS 
Initializing PDAIDS part 3 of 5 






From part 1 



From part 1 



4C12D TRACE PARTITION = 



Enter GO 
and press 
END key 



Press 
END 
only 




Assume that ail 

partitions 

are to be traced 



SP - Supervisor 
BG - Background 
F4 - Foreground 4 
F3- Foreground 3 
F2 - Foreground 2 
F1 - Foreground 1 



Trace specified 
partitions 







o 



Begin trace routine 




Store F/L events 
in the PD area or 
an alternate area 



//EXECPDAID 

PDAID=XX 

/* 

// ASSGN SYS005,X'cuu' 

//MTCREW,SYS005 

//EXECPDLIST 

/* 

/& 



Display F/L events 
as they occur 



Display F/L events 
using this utility^ 
progra m 



Display F/L events 
by 'dumping' 
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PDAIDS 

Initializing PDAIDS part 4 of 5 



From part 1 



From part 1 



SP - Supervisor 
BG- Background 
F4 - Foreground 4 
F3 - Foreground 3 
F2 - Foreground 2 
F1 - Foreground 1 




A 



4C12D TRACE PARTITION = 



SPECIFY 
partition 
to be traced 



Enter Go 
and press 
END key 



4C16D TRACE SVC 



Specify the hexadecimal SVC number 
to be traced by the GSVC trace. A 
maximum of 6 may be specified. 



Assume all 
partitions to be 
traced 



SVC(s) 
to be 
traced 



Press 
END 
only 



Enter Go 
and press 
END key 



Specify the hexadecimal SVC number 
to be ignored by the GSVC trace. A 
maximum of 6 may be specified. 



4C15D IGNORE SVC 



Specify Press 

SVC(s) or END 

to be ignored only 



Enter Go 
and press 
END key 



Trace these SVCs 
(Maximum of 6) 



Ignore only 
these SVCs 
(Maximum of 6) 



I 



o 



Assume that all 
SVCs are to be 
traced 



f 

I Begin trace routine 




Store SVC events 
in the PD area or 
an alternate area 



//EXECPDAID 

PDAID=XX 

/* 

// ASSGN SYS005,X'cuu' 

//MTCREW,SYS005 

// EXEC PDLIST 

/* 

/& 



Display SVC events 
by 'dumping' 



Display SVC events 
using this utility 
program 



Display SVC events 
as they occur 
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from part 1 



from part 1 



PDAIDS 
Initializing PDAI DS part 5 of 5 



4C13D IGNORE DEVICE = 



Select 

device (s) 

to be ignored 



Press 
END 
only 



Enter GO 
and press 
END key 



4C14D TRACE DEVICE 



Press 
END 
only 



Select 
device to 
be traced 



Enter GO 
and press 
END key 



Ignore 
these 

devices (Max. 
of 3) 



Assume all 
devices to be 
traced 



Trace only these 

devices 

(Max of 3) 



i=J 



O 



4C12D TRACE PARTITION 



Press 
END 
only 



I 



Enter GO 
and press 
END key 



Specify 
Partition 
to be traced 



Assume all 
partitions to 
be traced 




Specify the hexadecimal channel and 
unit number of the device to be 
ignored X'CUIT and press END key 
A maximum of 3 may be specified. 

Note: 

The trace and ignored options are 

mutually exclusive. 

Specify the hexadecimal channel and 
unit number of the device to be 
traced X'CUIT and press END key. 
A maximum of 3 may be specified. 




SP Supervisor 
BG Background 
F4 Foreground 4 
F3 Foreground 3 
F2 Foreground 2 
F1 Foreground 1 



Assume all 
devices and all 
partitions to 
be traced 



Commence trace 
routine 



//EXECPDAID 

PDAID=XX 

/* 

// ASSGN SYS005,X'cuu* 

//"MTCREW,SYS005 

//EXECPDLIST 

/* 

/& 



n 



Store QTAM 
events in 
PD area or an 
alternate area 



Display QTAM 
events using this 
utility program 



I 



Display QTAM 
events by 'dumping' 
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PDAIDS 



The following six examples show job streams to initiate trace routines through 
SYSIPT. 

Examples 1 — I/O Trace Function (single entry per card): 



//JOBCARDINP1 

//EXECPDAID 

PDAID=IT 

AAA=2K 

IGNORE DEVICE=190 

IGNORE DEVICE=191 

GO 

/• 

/& 



Calls for initializer. 
Calls for I/O trace function. 
Specifies alternate save area. 
Ignores events from 190. 
Ignores events from 191. 
Signals end of input. 



Note: No output device is specified; therefore, core-wrap is selected by default. To 
obtain the data, held in the alternate area, SYSLST must be assigned to either a 
line printer, tape unit, or disk drive. Exercise care, therefore, during termination 
ofPDAID. 

For example: 

//ASSGN SYSLST, X'1 91' 
//EXECPDAID 

ensures that the alternate area is dumped on device 191 before responding XX to 
the message 4C10D PDAID=. 

Example 2 — I/O Trace Function (multiple entries): 



//JOBCARDINP2 

//EXECPDAID 

PDAID=IT, IGNORE DEVICE=00E, 

OUTPUT DEVICE=180, 

GO 



Calls for initializer. 



Calls for I/O trace function. Specifies that 
the function ignore interrupts from 00E and 
record I/O events on 180. (Assume 180 is a 
tape unit) Signals end of input. 



\A Aj 



//EXEC ASSEMBLY 

Source 

Deck 


I/O activity of assembler will be traced; 
output will be on tape drive 180. 


/* 

//EXECPDAID 

PDAID=XX, 

/* 

// ASSGN SYS005,X' 180' 

// MTC REW,SYS005 
//EXECPDLIST 

/* 


Terminates I/O trace function. 


Assigns tape to SYS005. 

Rewind the tape. 

Print out contents of tape on the printer 

using the PDLIST program. 

program. 



/& 



Tape is formatted and listed on SYSLST. 
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Example 3 — Fetch/Load Trace Function (partitions specified): 



Trace Routines 

PDAIDS 



//J0BCARDINP3 

//EXECPDAID 

PDAID=FT 

TRACE PARTITION=F2 

TRACE PARTITION=BG 

GO 

/* 

/& 



Calls for initializer. 
Calls for F/L trace function. 
Trace foreground 2 partition. 
Trace background partition. 
Signals end of input. 



Note: Because no output device (OUTPUT DEVICE=) is specified, core-wrap is 
selected by default. 



Example 4 — Fetch/Load trace Function: 



//JOBCARDINP4 

//EXECPDAID 

PDAID=FT 

OUTPUT DEVICE=00E 

GO 

/*■ 

/& 



Calls for initializer. 
Calls for F/L trace function. 
Specifies printer output. 
Signals end of input. 



Note: All partitions are traced if this is a multiprogramming system. 



Example 5 — GSVC Trace Function: 

//JOBCARDINP5 

//EXECPDAID 

PDAIDK3T 

OUTPUT DEVICE=00E 

TRACE PARTITION=BG 

TRACE PARTITION=F2 

TRACE SVC=01 

TRACE SVC=04 

GO 

/* 

/& 

Example 6 — QTAM Trace Function: 

//JOBCARDINP6 

//EXECPDAID 

OUTPUT DEVICE=180 

TRACE DEVICE=183 

TRACE DEVICE=00E 

GO 

/* 

/& 



Calls for initializer. 
Calls for GSVC trace function. 
Specifies printer output. 
Trace background partition. 
Trace foreground 2 partition. 
Trace SVC 1. 
Trace SVC 4. 
Signals end of input. 




Calls for initializer. 
Specifies tape output. 
Trace events on tape drive 183. 
Trace events on printer. 
Signals end of input. 



Note: All partitions are traced if this is a multiprogramming system. 
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PD A I DS The following five examples show job streams to initiate trace routines through 

SYSLOG. 

Example 1 — Store all I/O events in core using PD area for tables: 

//JOBTYPINPT1 

// EXEC PDAI D Calls for initializer. 

4C10D PDAI D= Console requests function. 

IT and press END Operator response: I/O trace function. 

OUTPUT DEVICE= Console requests output device. 

GO Operator response: end of input (PD area 

is used for output). 

Note: Because no output device is specified, core-wrap mode is selected by default. 



o 
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Example 2 — Trace I/O events from three specified devices, using printer output: 



Trace Routines 

PDAIDS 



//JOBTYPINPT2 
//EXECPDAID 
4C10DPDAID= 
IT and Press END 
OUTPUT DEVICE= 
00E and press END 
IGNORE DEVICE= 
Press END 
TRACE DEVICE= 

180 and press END 
TRACE DEVICE= 
090 and press END 
TRACE DEVICE= 
01 F and press END 

Note: GO does not have to be specified here. The initializer knows this is the end 
of input because three TRACE entries have been made. 

Example 3 — Trace only the background partition and store the F/L events in the 
PD area: 



Calls for initializer. 
Console requests function. 
Operator response: I/O trace function. 
Console requests output device address. 
Operator response: printer output. 
Console requests IGNORE parameters. 
Operator response: no devices to be ignored. 
Console requests devices to be traced and 
the operator specifies them. 



//JOBTYPINPY3 

//EXECPDAID 

4C10DPDAID= 

FT and press END 

OUTPUT DEVICE= 

END 

AAA= 

Press END 

TRACE PARTITION 
BGand press END 
TRACE PARTITION^ 
GO and press END 



Calls for initializer. 

Console requests function. 

Operator response: F/L trace function. 

Console requests output device. 

Operator response: core-wrap mode. 

Console requests alternate area. 

Operator response: no AAA; store events in 

PD area. 

Console requests partition to be traced. 

Operator response: background. 

Console requests second partition. 

Operator response: end of input. 




^tojjpr 
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PDAIDS 



Example 4 
on printer. 



Trace all SVC's in both foreground partitions and list events 



// JOBTYPINPT4 

//EXECPDAID 

PDAID= 

GT and press END 

OUTPUT DEVICE= 
00E and press END 
TRACE PARTITION^ 
F1 and press END 
TRACE PARTITION 
F2 and press END 
TRACE PARTITION= 
Press END 

IGNORE= 
Press END 
TRACE SVC= 
GO and press END 



Calls for initializer 

Console requests function 

Operator response. Generalized SVC trace 

function 

Console requests output device 

Operator response: Printer output 

Console requests partition to be traced 

Operator response: foreground 1 

Console requests second partition to be traced 

Operator response: foreground 2 

Console requests third partition to be traced 

Operator response: no more partitions 

to be traced 

Console requests first SVC to be ignored 

Operator response: No SVCs to be ignored 

Console requests first SVC to be traced 

Operator response: Trace all SVCs: end of input 



o 
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Example 5 - Trace interrupts on tape drive 180 and printer 00E using the QTAM 
trace function and store the events in the PD area: 



Trace Routines 

PDAIDS 



//JOBTYPINPT5 
//EXECPDAID 
4C10DPDAID= 
QT and press END 
OUTPUT DEVICE= 
Press END 
AAA= 
Press END 
IGNORE DEVICE= 
Press END 
TRACE DEVICE= 
180 and press END 

TRACE DEVICE= 
OOEand press END 

TRACE DEVICE= 
Press END 

TRACE PARTITION 
F4 and press END 
TRACE PARTITION^ 

Press END 



Calls for initializer. 
Console requests function. 
Operator response: QTAM trace. 
Console requests output device address. 
Operator response: PD area. 
Console requests alternate area. 
Operator response: no alternate area. 
Console requests device to be ignored. 
Operator response: no device to be ignored. 
Console requests device to be traced. 
Operator response: Trace interrupts on 
device 180. 

Console request second device to be traced. 

Operator response: trace interrupts on device 

00E. 

Console requests third device to be traced. 

Operator response: no third device; end of 

input. 

Console requests first partition to be traced. 

Operator response foreground 4. 

Console requests second partition to be 

traced. 

Operator response: end of input. 







f% 
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PART 2 SDAIDS 



General description 

SDAIDS provide further tracing facilities to supplement those already provided by 
the PDAIDS. While the PDAIDS produce a predefined output for each type of 
trace, as described in Part 1 of this Section, most of the SDAID trace functions can 
be initiated to produce information that is more defined for a given type of system 
malfunction. The SDAID printout ranges from one printed line for each event up to 
a dump of the complete real storage for each event. (No events will be lost as 
they may be with PDAID output.) SDAIDS also provide special dumping 
facilities that enable non-destroying dumps to be executed on the occurrence of 
specific events during program operation. 

CAUTION 

The effect on the operation of programs currently running in the system that are 
time dependent, for example, a program using MICR or teleprocessing as input/ 
output, must be considered before using this serviceability aid. 



The SDAID trace functions are as follows: 

1. A page trace, consisting of 

• a page translation exception trace (when a page fault occurs) 

• a page enque trace (when a page is placed in the page queue) 

• a page handling trace (when a page is removed from the page queue) 

2. An instruction trace that records instructions in the order in which they are 
executed between any selected addresses. 

3. A main storage alter trace that records the address of the instruction that 
altered the contents of any or all byte locations between any selected 
addresses. 

4. A general register alter trace that records any alteration made to any one, or 
any selected, general registers. 

5. A successful branch trace that records the address at which a successful branch 
is made, between any selected addresses. 



o 



J 



The stop and dump facilities are: 

1. Stop on event: On the occurence of one or any of the following specified 
events, all system activity is suspended after SDAID output is complete. 



at any specified instruction address 

on alteration of any byte location between any selected addresses 

on alteration of one or more specified general registers 

on any successful branch that occurs between any selected addresses 

on the occurrence of a page translation exeption 

on the occurrence of a program check code X'01'— X'10' and X'12' 

on the occurrence of a request for a page to be placed in the PG queue 

(page fault enqueued). 

on the occurrence of a request for a page to be removed from the PG 

queue by the page handler. 
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Trace Routines 

2. As well as being able to obtain a dump of areas specified by the output class at SD Al DS 

the stop event, it is possible to obtain a dump of real and virtual address areas 
after the specified output class has been dumped. 

The types of dumps that can be obtained in this way are: 

• Non-destroying dump: This is a dump of all real storage. It can be obtained if 
required after a stop on event. The dump is non-destroying because system 
status information is preserved, thus enabling system operation to continue 
after execution of the dump. 

• Dump on a program check: On the occurrence of a program check interrupt 
(codes X'OT to X'OF', X'10', and X'12'), a non-destroying dump of the 
complete supervisor area is automatically executed. 

• PDUMP: Enables a dump of a minimum area of 32 bytes (one print line) 
between two virtual address limits. The maximum area that can be dumped 
depends only on the size of virtual storage, and only virtual address 

area information that is in real storage is dumped. 

System requirements 

The SD area need not be specified during system generation, but the SDAID initial- 
izing and terminating programs must be cataloged in the core image library. 

SDAIDS make use of program event recording and monitoring, described in 
Appendix E. 

Output from all SDAIDS routines is directed to a line printer. The line printer is 
non -dedicated, meaning that the same printer may be used as an output device for 
other programs as well as for the SDAIDS. Therefore, SDAID output may be 
interspersed with job output. 

Note: the following restriction, if the printer is connected via a selector or block 
multiplexer mode channel: 

No other devices must be running on the same channel as the printer at the moment 
when SDAID attempts to write to the printer. 
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SDAID Characteristics 

• SDAIDS reside in the SD area, which must occupy at least 6K bytes of the 
real address area. 

The storage assigned to the SD area is taken from the page pool. 

• SDAID is initialized by // EXEC SDAID, and requires 12K of a real or virtual 
partition (only during initialization of any SDAID function). Parameters, 
specified either at initialization time or later, must be entered on the console. 

• After initialization, SDAID does not use DOS/VS services. 

• SDAID has immediate control in case of a program check interruption. 

• SDAID runs with DAT (Dynamic Address Translation) off, disabled for I/O and 
external interrupts. 

• After SDAID handled event, processing continues as if event handling had not 
occurred. 

• Only the contents of the real address area is dumped with SDAID. (Pages that 
currently reside only on the page data set will not be dumped.) 

• SDAID may not be used to debug time-dependent programs because it runs 
disabled while recording events and thus delays processing. 

• Because SDAIDS use the program event recording PER facility, and because 
time is required to print SDAID output, program execution time is increased. 
Its effect on the operation of time-dependent programs must therefore be 
considered before using this serviceability aid. Performance degradation when 
using SDAIDS will be reduced when the FASTREC output class is selected. 

• Debugging of printer error recovery routines is possible only if the FASTREC 
output class is used. 

• If, during the printing of SDAID output, the line printer is stopped for any 
reason or becomes not ready, the system will enter a wait state with a message 
in low address storage. To continue printer operation, press the EXTERNAL 
INTERRUPT key. 

• When initialization is complete, the event handling routines within the SDAID 
initiating program partition are transferred to the SD area. The 1 2K partition 
can then be re-used, but the pages occupied at the end of the page pool by the 
SD area are not released for normal program use until all SDAID functions are 
terminated. 
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Terminating the SDAID routines 

The tool SDAID is terminated, and the SD area is released to the page pool by 

one of the following: 

1 . The AR (attention routine) command ENDSD 

2. The job control statement // EXEC ENDSD 

Note: Depending on the events being traced and the event limits specified, it may 
take some time before the attention routine or job control becomes active. One 
method to avoid this delay is to clear control register 9 using the ALTER /DISPLA Y 
console feature before requesting the attention routine. 
This de-activates all PER event tracing. 
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Using SDAID and PDAID concurrently 

If the system has been generated to accept PDAIDS, any one of the PDAID trace 
routines may run concurrently with SDAID. However, if the PDAID currently 
running is using an alternate area, it must first be terminated before an SDAID 
routine can run. 






SDAID Events 

SDAID events are recognized as program checks. There are two groups of events: 
elementary events and dedicated events. 

Elementary events are: 



Mnemonic 


Event 


BR 

IF 

SA 

GA 

TE 


successful branching 
instruction fetching 
storage alteration 
general register alteration 
page translation exception 



Dedicated events are: 



Mnemonic 


Event 


PGMCHK 

PAGENQ 
PAGEHDL 


program interruption codes 
X'OV-X'OF' and X'10\ X'12' 
request for page is enqueued 
request for page is handled 




SDAID output information 

When an event occurs, the SDAID event handling routines will record either the 
information specified by output class parameter (for elementary events), or 
predefined data (for dedicated events). 

By using the output class parameter of the SDAID operand OUTCL= the amount and 
and type of information required for offline program debugging can be selected for 
the elementary event during initialization of the SDAIDS. After initialization, the 
output class can also be re-specified if required. 

For elementary events the output class can be specified according to Table B-6-A. 
However, if more than one elementary event is being traced simultaneously, the 
output class will be the same for all events. For each dedicated event, a 
predefined output is obtained as shown in Table B-6-B. 
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Output if more than one event is being traced: This is desirable when many events 
are to be traced between wide event limits. It decreases the amount of printer 
output and reduces print time. Therefore, the larger the space allotted to SDAID 
during initialization, the larger is the SD buffer area for FASTREC output. 

Events can be enabled individually or in combination with one another. If some or 
all of the events BR, IF, SA, and GA happen concurrently, the output class listed 
in Table B-2-A is printed only once. The event ID, however, contains the mnemonics 
of all current events. 

If any of the other events happen concurrently, even if they occur together with 
one of the events BR, IF, SA, or GA, the output is printed for each event that 
occurs. 

PDUMP output class: A PDUMP is triggered by events just as the other output 
classes. It dumps a minimum of 32 Bytes (one print line) between two virtual 
address limits. The maximum area that can be dumped depends only on the size of 
virtual storage. Any are a between the two limits, not in real storage, will be 
indicated by a message. 

Any PDUMP limits may be specified. However, the value of the limits in relation 
to the value X'CO' and to each other determines the output. 




No 



V^V 



Yes 



Upper 

'more than or equal^ 

to X'CO' 



Yes 



No 



Dumping to end 
of storage occurs 
(no wrap-around) 



SDAID forces 
lower limit of 
000000 



SDAID selects 
output class of 
LOCORE 



Note: The defaults for the PDUMP limits are the EVENT limits (X'ttlUV, 'hhhhhh ') 
specified in answer to message 4C61D, refer to Table B-10. 
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^^~~^^ Output classes 
^^\^^ and 
Recorded ^\^^ Mnemonic 
Information ^~"\ v ,^ 


OUTCL 1 


OUTCL 2 


OUTCL 3 


OUTCL 4 


OUTCL 5 


OUTCL 6 


OUTCL 7 


OUTCL 8 


OUTCL Q 


PSW 
01 


GPR 
02 


LOCO RE 
03 


COMREG 
04 


PAGETAB 
05 


SUPVISOR 
06 


DUMPREAL 
NDD07 


PDUMP 
08 


FASTREC** 
00 


Event ID* 

program old PSW, and time of day 

in microseconds 


X 


X 


X 


X 


X 


X 


Y *»# 


X 


X 


Instruction causing event 


X 


X 


X 


X 


X 


X 


x*** 


X 




General purpose registers 




X 


X 


X 


X 


X 


X 


X 




Low core (X'000'-X'1 1 F') 






X 


X 


X 


X 


X 






Current COMREG and SYSCOM 








X 




X 


X 






Control registers, 






X 


X 


X 


X 


X 


X 




segment tables, 
page tables, 
page frame table 










X 


X 


X 

¥ 






Complete supervisor 












X 


X 






Complete real address area 














X 






Virtual dump between 
PDUMP address limits 
















X 




TE-MASK 

PER mask (control register 9) 

GPR mask (control register 9) 

PER start address (control register 10) 

PER end address (control register 1 1 ) 

general purpose registers 1 3, 14, 1 5, 0, 1 , 2 


















X 



Notes 

* Event ID for BR, IF, SA, and GA — event mnemonic and instruction address. 

Event ID for TE — mnemonic TE and address of the page causing TE. 
** FASTREC is an output class that stores the described information into an SDAID internal buffer. 

Information for several events is stored and printed as one block. 
*** INSTR and PSW are not printed if NDD is forced after STOP ON EVENT VIA NDD BYTE X'FF'. 

Table B-6-A . Output class options for SDAID elementary events. 

Examples at the end of this section 2-F show several types of output specified by the output class parameter. 




in 
D 
> 

D 
CO 



o 

CD 

J3 
O 

c 
^_ 

5' 

CD 
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Recorded Information 


Dedicated Event 


PGMCHK 


PAGENQ 


PAGE HDL 


Event-Mnemonic 

Program old PSW, 

Time of day in microseconds, 

Complete supervisor. 

Instruction at time of PGMCHK 

Control registers 

General purpose registers 


X 






Event- Mnemonic 

Requestor-ID 

(TE/GETR/TFIX/PFIX) 

Task-ID 

Address of page to be handled 




X 


X 


Protection key associated with 
page to be handled 




X 


X 


Address of page frame 

to which the page is assigned 






X 



o 



Table B-6-B. Predefined output obtained from SDAID dedicated events. 



Specification of area to be traced 

For elementary events, two addresses may be specified during SDAID initialization 
as the start and end addresses of the area to be traced or monitored. These 
address limits are interpreted as virtual addresses if the DAT bit in the PSW is on. 
Address limits are not applicable to dedicated events, for which the SDAID 
program includes all real and virtual address areas. 

If the start address specified is higher than the end address, tracing commences from 
the higher address and continues to the end of virtual storage (the maximum 
address being 16,777,215). Tracing continues from address 000000 up to the end 
address (the lower address specified). This is termed "wrap around tracing". 



o 
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Description and operation SD A I DS 

Translation exception trace 

This occurs when an instruction requires a page to be paged in from the page data 
set in order for the instruction to be completed. An example is an MVC instruction 
whose address 1 is in page frame x in real storage, and whose address 2 is in page y 
that is not in real storage. 

When this trace is initialized, any page fault generated because of such an instruction 
is printed along with the instruction and its address that caused the page fault, plus 
the output of the specified output class. 

Page enqueue trace 

This trace enables the sequence to be traced in which programs are calling for 
pages. Page faults caused by translation exceptions will also be traced with 
this routine. 

Page handling trace 

This trace provides information about the sequence in which pages are paged in 
from the page data set. After a page is handled, a trace output is printed. 

When to use: Use this trace if you suspect that the loss of a page, or the sequence 
of page usage by a program, is causing programming errors. This trace gives you page 
management information during program execution. 
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Instruction trace 

This trace records information about the order of instruction execution within any 
selected area of storage during program execution. The amount and type of 
information provided depends on the output class selected during initialization of 
the trace. 



When to use: If an unintended loop develops during program execution, this trace 
can be initiated and the program re-run. During the re-run, a list of all the instruc- 
tions executed within the loop will be traced. This is an efficient method to 
obtain a loop trace. 



Storage alter trace 

This trace records information about instructions that alter one or more locations 
in virtual storage between address limits that can be specified. The amount and type 
of information provided depends on the output class selected during initialization 
of the trace routine. 



When to use: If, for example, you suspect I/O areas or count locations for loops, 
information obtained from this trace output will show the instructions that are 
altering the areas. The SA trace will not record changes in the contents of locations 
that are changed directly by I/O channel operations. 



General register alter trace 

This is similar to the virtual storage alter trace. It should be used when information 
about changes to any GR during program execution is required to help during 
offline program debugging. Any GR or any combination of GRs can be traced. 



Successful branch trace 

This trace provides a check on the logical path of a program during its execution 
in any selected part of virtual storage. 



o 



When to use: Use this trace if the actual path taken by a program cannot be 
analysed from the program flowcharts and listings. You can also use it to provide 
information about the path taken, for example, by a long loop. 
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Stop and dump routines SDAIDS 

Stop on event 

This facility stops all system activity on the occurrence of a specified event. At the 
stop on event, the system is held in a wait state. 

Processing continues via external interrupt. 

With the system in this wait state, the operator or programmer can either use 
hands-on debugging aids or obtain a non -destroying dump. 

The specified event can be one or more of the elementary or dedicated events. 

When to use: 

1 . Use this routine if hands-on debugging is necessary on the occurrence of one of 
the specified events. For example, when a change occurs in a general register, 
you may want to look through the program listings to enable you to decide on 
the next step in isolating an error. When the stop occurs, it is also possible to 
initiate another SDAID routine that will provide additional system information 
for offline program debugging. 

2. When no time is available for hands-on debugging, the non-destroying dumps 
obtained when the stop on event occurs will provide a great deal of additional 
information for offline program debugging. 

Stop on address 

This facility provides a stop on address on any specified (real or virtual) address. 
When the stop occurs, the system is held in a wait state, and the operator or 
programmer can use hands-on debugging aids or obtain a non-destroying dump. 

When and how to use: This facility is used under conditions similar to those for the 
hardware stop on address compare, that is, hands-on debugging is to be carried out 
when a program has reached some specific point during its operation. However, this 
aid enables a stop on all SDAID events. 

The stop on address is accomplished by initiating the instruction trace, specifying 
stop on event, and entering the address at which the stop is required as the address 
supplied within the event limit field during initialization of the trace. 
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Non-destroying dump: This is a dump of real storage that can be obtained after 
the occurrence of a specified event during the stop on event. The dump is non- 
destroying because the system is placed in a wait state on the occurrence of the 
specified event, and because SDAIDS do not destroy system status during 
execution of the dump. 

How to obtain the dump: The following procedure describes how to obtain the 
non-destroying dump: 

1 . When the system is in the stop-on-event wait state, locate the real storage 
address of the NDD (non -destroying dump) byte switch. 

The address of this program switch is printed during SDAID initialization. 
Refer to point 3 of the example in this section which shows the SDAID 
initializing output part 2. 

2. To ensure that the wait state is the true stop-on-event wait, use the ALTER/ 
DISPLAY console feature to display the PSW. The instruction address part of 
the WAIT PSW will be OOOOEEEE. 

3. To obtain the dump, set the NDD byte to X'FF', using the ALTER/DISPLAY 
console feature as described in this Section 2-D. 

4. Press the START key and then the EXTERNAL INTERRUPT key. A non- 
destroying dump will be printed and processing continues. 

When the dump is complete, the NDD byte is reset by the SDAID program, and so 
a dump will not occur at the next stop on event. To obtain another dump at any 
following stop, the NDD byte must again be set on. 

Note: The dump can be discontinued by the following procedure: 

1. Make the line printer used as SDAID output device unready. 

2. Now make the printer ready. 

3. Press the EXTERNAL INTERR UPT key two times within one second. 

When to use: This SDAID facility enables you to obtain the information needed 
for problem analysis without having to take dumps of real storage at every 
occurrence of an event. Therefore this decreases the amount of paper to be searched 
through during offline debugging. For example you may consider it sufficient 
for offline debugging to take a dump at every twenty seventh occurrence of an 
event. 
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Dump on a program check: On the occurrence of a program check interrupt codes 
X'GT - X'OF', X'10', and X'12', the following information is dumped automatically: 
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Event ID 

Program old PSW 

Time of day in microseconds 

Control registers 

General purpose registers 

Real storage from byte location to the end of the supervisor area, and the 

contents of the SDAID buffer. 



After this automatic non-destroying dump is executed, the DOS/VS program 
check handler routine will be entered. 

When to use: If PDAIDS are not available on your system, the use of the SDAID 
dump on a program check is the only way to obtain a non-destroying dump of the 
supervisor transient area at the time of a program check interrupt. 

The SD area 








SUPERVISOR 


1 Real Partitions j 
J if any. |_ 


SUPERVISOR 














MAIN 
PAGE 
POOL 


MAIN 
PAGE 
POOL 






.______. 


[ SDAID resident code 
| and work space. 

V SD Buffer 


SD AREA 
" (6K by default) 


) 

END OF 
REAL ST 


3RAGE 


/ 
END OF 

REALSTC 


DRAGE 


Length of each event is 64 bytes. 



Real storage allocation 
before initializing SDAIDS 



Real storage allocation 
after initializing SDAIDS 



How to locate 

The address of the beginning of the SD area is printed on the device assigned to 
SYSLST during initialization of SDAID. Refer to page 2.90 for an example of 
SDAID initializing output. 
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Initializing SDAID 

SDAID may be initialized in any real or virtual partition by entering the following 
execute statement via SYSLOG or SYSRDR: 

//EXEC SDAID 

An operator/ system dialog follows, beginning with the message: 

4C55D GIVE SPACE FOR SDAID= 

The operator may respond by pressing the END key (which gives a default value of 
6K to SDAID), or he may specify a value nK, where n represents a multiple of 1024 
bytes. The maximum value that may be specified is 999K. If an odd number is 
specified, the value is incremented to the next even number. The SDAID space is taken 
from the main page pool. If the main page pool is not large enough to accept the 
area specified, an area of the size PPOOL-16K is automatically taken, with a minimum 
of 6K. If the page pool is not large enough to accept the minimum(6K), the following 
message is printed on SYSLOG. 

4C56E INSUFFICIENT SDAID SPACE, REALLOCATE 

The MAP command should be issued before reallocating real partition areas in 
order to increase the size of the page pool before re-initializing SDAIDS. 

The following message will be issued if this is a second request for SDAID space: 

4C70E DUPLICATE REQUEST FOR PDAID AND/OR SDAID 

This message is also issued if PDAID using the core wrap output mode in an 
alternate area is active in the main page pool and a request for SDAIDS is made. 
When the space allocated to SDAID is accepted, a message dialog follows that allows 
the operator to select one or more events to be traced and to specify between which 
address limits of real or virtual storage the events are to be traced. (Event limits 
do not apply to event PAGENQ, event PAGEHDL, and event PGMCHK.) The dialog 
also enables the selection of a line printer at a device address other than X'OOE', 
which is the device address by default. However, the device must be a line printer. 

An output class may also be specified (refer to Tables B-6-A and B-6-B in this chapter). 
A response of EOB (pressing the END key) to all SDAID messages will give default 
values. 

When the SDAID message dialog is complete, the SDAID initializing outputs part 
1 and 2 are issued to the device assigned as SYSLST. This need not be the same 
device on which SDAID trace output is printed. The SDAID trace output is printed 
immediately after the initializing output on the device at the address specified in 
the reply to message 

4C58D OUTPUT DEVICE= 

(Address X'OOE' is taken as default.) After initialization, the partition used for the 
initialization is given back to the main page pool. 

The table shown in Figure B-3 lists all SDAID messages in the order in which they 
are issued and describes the responses. 

SDAID job entry examples are shown after the example of the SDAID initializing 
output. Operator flowcharts follow. 

SDAID messages after initialization time 

4C71 1 SDAID FOUND PRTR STATUS CSW SENSE 

This message may be written out on the printer. It is accompanied by the CSW and 
SENSE information if applicable. It indicates that the previous printer operation 
which was started may not have been completed successfully. 



v> 
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Altering SDA ID functions and /or address limits after initialization 

When the SDAID is initialized, trace functions and events limits, where applicable, 
can be changed by altering the SDAID program parameters directly in storage. 
The contents of the parameters at the addresses printed on part 2 of the SDAID 
initializing output, and of control registers 8, 9, A, and B, must be altered to 
predetermined values. Their values are also printed in the initializing output. 

To make SDAID parameter changes: 

• Press the STOP key. 

• Use the console ALTER/DISPLAY feature to alter the contents of the 
program parameters. 

• Press the START key. 

Note: When SDAID is terminated and later re-initialized, new SDAID parameters 
are printed in the SDAID initializing output. 

Note: SDAID requires SYSLSTfor the initializing output. Therefore, if you 
intend to change SDAID parameters after initializing SDAIDS, you should ensure 
that the SYSLST device is a line printer on the partition used for SDAID 
initialization. 
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A note to programmers 

SDAIDS are primarily designed to be initialized before re-running failing programs. 
If you, as the programmer, are debugging on the system (hands-on debugging), it 
is recommended that you initiate SDAIDS without specifying any events. (Press 
the END key as a response to all SDAID messages.) SDAID is then retained in the 
page pool ready to be activated. The failing programs can then be executed and 
SDAID events made active by entering event parameters directly into control 
registers 8, 9, 10, and 11. For example, altering the contents of the high-order byte 
of control register 9 (by the console ALTER/DISPLAY feature) enables you to 
activate any one or all of the events BR, IF, SA, and GA. 

You can also specify which general registers are to be traced by entering values 
into the lower 2 bytes of control register 9. Control registers 10 and 1 1 contain, 
respectively, the start and end addresses for the event limits. The output of the 
MAP command will tell you the partition in which the failing programs reside. 

From the MAP output you can also obtain the addresses of the upper and lower 
limit of the partition, which can then be used as the event limits for the SDAID 
trace. (Note that addresses printed by the MAP command are decimal.) 

If you are unable to use the system for hands-on debugging, you as the programmer 
must specify clear instructions to the operator about the events to be traced and 
the event limits to be used. 
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Message 
Code 



4C58D 



4C60D 



4C61D 



4C59D 



4C62D 



4C63D 



4C64D 



4C65D 



4C66D 



4C67D 



4C68D 



4C69D 



Message issued 
on SYSLOG 



OUTPUT DEVICE= 



STOP ON EVENT= 



EVENT LIMITS= 



OUTCL= 



EVENT BR= 



EVENT IF= 



EVENT SA= 



EVENT GA= 



EVENT TE= 



EVENT PGMCHK= 



EVENT PAGENQ= 



EVENT PAGEHDL= 



Parameters entered by Operator 



X'OOE ' [,GO] 
X'cuu' [,GO] 
GO 



END/ENTER 



YES 

NO 



[-GO] 



END/ENTER 



X'000000'.X'FFFFFF' [,GOj 
. X'llllll' [,GO] 

.X'hhhhhh' [,GO] 
,GO 



X'llllll' 



END/ENTER 



PSW 

GPR 

LOCORE 

COMREG 

PAGETAB 

SUPVISOR 

DUMPREAL 



,GO 



PDUMP 



FASTREC 



, lower and upper event limit [,GO] 



,X'aaaaaa' 



,GO 



.Upper event limit [,GO] 
,X'bbbbbb' CGO] 
,GO 



. PGMCHK [,GO] 
.AUTOMATIC [,GO] 
/GO 



END/ 
ENTER 



YES 
NO 



[GO] 



END/ENTER 



YES 
NO 



Cgo] 



END/ENTER 



YES 
NO 



LgoI 



END/ENTER 



X'012...EF' [.GO] 
NO 



END/ENTER 



YES 
NQ 



[,GO] 



END/ENTER 



YES 
NO 



[.GO] 



END/ENTER 



Remarks 



X'llllll'.X'hhhhhh': 
Lower and upper limit of virtual 
storage to be traced with events 
BR, IF.SAand TE. 



Valid output classes for the events 
BR, IF.SA, GA, andTE. 
END/ENTER 

PGMCHK: Causes wrap around 
mode of internal buffer. It is 
written each time a PGMCHK 
event occurs. AUTOMATIC: 
If the internal buffers is full, 
it is written out. 



Designate the general purpose 
registers to be traced. At least 
one must be specified. 



YES 

NO 



Lgo] 



END/ENTER 



YES 
Np. 



END/ENTER 



\,y 



\_> 



Note: Go cannot be entered as a first parameter. If it is, the dialogue is terminated ; defaults (underlined) are taken or the parameters 
are ignored by SDAID. 

Table B-10. The parameters required to initialize SDAID event tracing. 
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//JOBSDTRACE 
//EXECSDAID 



4C53I TOD IN ERROR STATE 



or 



4C54I TOD NOT OPERATIONAL 



Select size of SD area 



Enter n 
(a value) 



Press 
END 



4C70E DUPLICATE REQUEST FOR PDAID 
AND/OR SDAID 
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I No operator response is required to 
I, either of these messages if they are 
Iprinted. The time stamp on SDAID out- 
tput will be zero. 



^Maximum area you may specify is 999k. 
\lf n is an add integer, the value is 
lincremented to the next even number. 



I This message is issued if SDAID has 
\been initiated and not terminated before 
ia second request to initiate SDA ID is made. 
| The duplicate, or second request for 
ISDAID is automatically canceled. (This 
^message is also printed if a request to run 
la PDAID core-wrap output in an alter- 
Inate area is made while SDAID is active . 



4C56E INSUFFICIENT SDAID SPACE 
REALLOCATE 



Device X'cuu' must 
be a line printer 



Select a device 



Enter 
X'cuu' and 



Enter 
GO 



Enter 
X'cuu' 



GO and press END I and press END] and press END 



Press 
END 



Use device 
X'cuu' for 
output 



Use device 
X'OOE'for 
output 



Use device 
X'cuu' for 
output 



If this message is printed, the SDAID job 
is terminated. Before re-initializing 
SDAIDS you must decrease the size of 
real partitions, thus increasing the size 
of the main page pool for the SD area. 



Use device 
X'OOE' for 
output 





To part 2 



To part 2 
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From part 1 



From part 1 








4C60D STOP ON EVENT = 



Enter GO 
and press 
END 



Enter YES 

and GO 

and press END 



Enter YES 
and Press 
END 



Press 
END 



No stop 
on event 



Trace events 
across all of 
virtual storage 



Refer to Table B-6-A for a 
description of SDAID output 
classes. 

(FASTREC,GO generates the 
default of PGMCHK). Output 
class for the events PGMCHK, 
PAGENQ, and PAGEHDL is 
predetermined. Refer to 
Table B-6-B 



Stop 
on event 



Enter GO 
and press 
END 



Enter GO 
and press 
END 



Take default 
output class of 
PSW (01) 



To part 3 



Stop 
on event 



No stop 
on event 



4C61D EVENT LIMITS 



Enter GO and 
press END 



Specify event limits and 

~~~ I 

or 



Press 
END 



Trace events 
between limits 
specified 



Press 
END 



Trace events 
between limits 
specified 



V^ 



Trace events 
across all of 
virtual storage 



4C59D OUTCL = 



Enter GO and 
press END 



Specify an output class and 
or 



Press 
END 



Use output 
class specified 



Press 
END 



Use output 
class specified 



Take default 
output class of 
PSW (01) 



( 



J,, 



To part 3 
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From part 2 
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4C62D EVENT BR = 



Enter GO 
and press 
END 



BR = Successful Branch Trace 



Enter YES and 



Enter GO and 
press END 



No BR trace 



Trace BR 
events 



Enter GO 
and press 
END 



No IF trace 



To part 4 



Press 
END 



Press 
END 



Trace BR 
events 



No BR trace 



4C63D EVENT IF = 



IF = Instruction Fetch Trace 



Enter YES and 



Enter GO and 
press END 



Press 
END 



Press 
END 



Trace IF 
events 



Trace IF 
events 



No IF trace 



3 




To part 4 
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Initializing SDAID, part 4 of 6 



From part 3 



Enter GO 
and press 
END 



No SA trace 



GA = General Purpose Register Trace 



From part 3 



4C64D EVENT SA = 



Enter YES and 



Enter GO and 
press END 



Press 
END 



Trace SA 
events 



Trace SA 
events 



SA = Storage Alter Trace 



Press 
END 



No SA trace 



4C65D EVENT GA = 



Enter GO 
and press 
END 



Specify GPR(s) to be traced, (in hex) 



Enter GO and 
press END 



T" 

or 



Press 
END 



No GPR trace 



Trace G PR (s) 
specified 



ZJ 



Press 
END 



Trace GPR (s) 
specified 



No GPR trace 



To part 5 



To part 5 






C 



2.92 Serviceability Aids. 



Page of GC33-5380-1, 
revised June 30, 1974, 
by TNL SN33-8780 



Trace Routines 






From part 4 




Enter GO 
and press 
END 



No TE trace 



From part 4 




SDAIDS 
Initializing SDAID, part 5 of 6 



4C66D EVENT TE = 



TE = Page Translation 
Exception Trace 



Enter YES and 



Enter GO and 
press END 



Press 
END 



Trace TE 
events 



Press 
END 



Trace TE 
events 



No TE trace 



*J 



4C67D EVENT PGMCHK= 



Enter GO 
and press 
END 



Enter NO and 



Enter GO and ' Press 

press END ■ END 



Trace 
PGMCHK(s) 



PGMCHK = Program check trace 



Do not trace 
PGMCHK(s) 



zr 



Do not trace 
PGMCHK(s) 



Press 
END 



Trace 
PGMCHK(s) 



3 



To part 6 



To part 6 



Serviceability Aids. 2.93 



Page of GC33-5380-1, 
revised June 30. 1974 
by TNL SN33-8780 



Trace Routines 

SDAIDS 

Initializing SD AID, part 6 of 6 



From part 5 



From part 5 



\/ 



4C68D EVENT PAGENQ = 



Enter GO 
and press 
END 



PAGENQ = Trace of page requests 
as they are placed in the page queue 



Enter YES and 



Enter GO and 
Press END 



Press 
END 



No PAGENQ 
trace 



Trace 
PAGENQ(s) 




Press 
END 



Trace 
PAGENQ(s) 



PAGEHDL = Trace of pages as they 
are allocated to a frame in the real 
address area — page request is 
removed from the page queue. 



No PAGENQ 
trace 



zr 



4C69D EVENT PAGEHDL = 



V> 



Enter YES 
and press 
END 



No PAGEHDL 
trace 



Press 
END 



Trace 
PAGEHDL 



No PAGE- 
HDL trace 



SDAID initializing output parts 1 and 2 are printed at this 
point during the initialization. The example opposite 
shows and explains the meaning of the initializing output. 
Retain this output if SDAID parameter changes are 
intended after initialization. 



4C57E SDAID SUCCESSFULLY INITIATED SDAREA=XXXXK 



2.94 Serviceability Aids. 



SDAID initializing output, part 1 



o 



SDAIO FOUND/ASSUNEO THE FOLLOWING PARAMETERS: 

SOAID START ADDRESS IS HEX 0003E800 

SDAID END ADDRESS IS HEX 0003FFFF 

SDBUFFER START ADDRESS IS HEX 0003FDC0 

SDBUFFER END ADDRESS IS HEX 0003FFFF • 

SDBUFFER CAN KEEP THIS NR OF EVENTS DEC 00000009 



1 PRINTER AODRESS IS HEX 

2 OUTPUT CLASS FIELD IS 

3 STOP ON EVENT 

4 EVENT LIMITS START HEX 

END HEX 

5 EVENT BR 

6 EVENT IF 

7 EVENT SA 

8 EVENT GA 



OOOE 
PSW 101 » 



00000000 
OOFFFFFF 



tffl. 



MASK BITS FOR GENERAL PURPOSE REGISTERS .0123456789ABC0EF 



0000000000000000 



9 EVENT TE 

10 EVENT PGMCHK . 

11 EVENT PAGENQ . 

12 EVENT PAGEHDL. 



Trace Routines 

SDAIDS 



3FFFF - 3F9oo = I7FF = 6/^3, 



7° yiedecv <f/l £rx<e^ on ££s 3, 

5 <z*u/ 7 &n*&r I000t5oo 






(£xZ3*r)\ 



SDAID initializing output, part 2 



o 



**** THESE ARE THE PARAMETERS THAT YOU CAN CHANGE FROM CONSOLE: 

» PROCEDURE: MACHINE IN STOPPED STATE, HIT ALTER/OSPLY, EXAMPLES BELOW 

* 

* TO ALTER CTL REG 9 TO 40000000 

* TYPE IN AC 9 40000000 END KEY 

• 

* TO ALTER MS LOCATION 03CC8C TO FF 

* TYPE IN AM 03CC8C FF ENO KEY 

**1 PRINTER ADDRESS ON HEX 03FD88 FORMAT OXXX 

* 

**2 OUTPUT CLASS ON HEX 03FD98 FORM UUYY 

* WHERE IF: UU=00 FASTREC 
« UU=01 PSW 

* UU=02 GPR 

* UU=03 LOCORE 

* UU=04 COMREG 

* UU=05 PAGETAB 

* UU=06 SUPVISOR 
» UU=07 OUMPREAL 

* UU=08 POUMP 

* YY=00 AUTOMATIC SDBUFFER OUTPUT ") . 

* YY=FF SDBUFFER OUTPUT ON PGMCHK J 
* 
»*3 STOP ON EVENT ON HEX 03FD94 X'FF'=YES, X«00'=NO 

* NONDESTROYING DUMP ON HEX 03F096 X»FF'=YES 

* 

**4 EVENT LIMITS START AODRESS .... CTL REG A HEX OOXXXXXX ADDR 

* ENO ADDRESS .... CTL REG B HEX OOXXXXXX ADDR 
* 

* PDUMP LIMITS START ADDRESS .... ON HEX 03FD9C OOXXXXXX ADDR 
» END AOORESS .... ON HEX 03FDA0 OOXXXXXX AODR 
* 
* 

* SDAID EVENTS: TO ENABLE — SWITCHON THE BIT/BYTE — 
* 

**5 BR EVENT CTL REG 9 HEX 80000000 BIT 

**6 IF EVENT CTL REG 9 HEX 40000000 BIT 

**7 SA EVENT CTL REG 9 HEX 20000000 BIT 

* 

**B GA EVENT CTL REG 9 HEX 10000000 BIT 

* GPR MASK (0-151 .. CTL REG 9 HEX 1000XXXX POSITIONAL 

* * 

**9 TE EVENT MAIN STORAGE 03FD8C HEX FF BYTE * 

» * 

*10 PGMCHK EVENT MAIN STORAGE 03F08E HEX FF BYTE * 

* * 

* 11 PAGENQ EVENT MAIN STORAGE 03FD90 HEX FF BYTE * 

* 12 PAGEHDL EVENT MAIN STORAGE 03FD92 HEX FF BY'TE * 

* * 
♦NOTE: SDAID NEEOS EXTERNAL INTERRUPT IF PRINTER BECAME UNREAOY * 

* * 

* « 

CPU-ID IS HEX P0010043J14SP0C0, _, 

4C57E SDAID SUCCESSFULLY INITIATED SDAREA=0006K T "^""CL- . 

f / ^ ^ ~ — CPU Mc^e/ 

CPU s 






yu/fuvt orti 



%/ictfK. 

- % 7" ^ = C . £^*2y- CO <*. 

£*■/ ' f. <f^£- So . 
face ^jvl Aa^C 4 <2^*e . 






The summary of parameters printed on the line printer 
after successful initialization of any SDAID routine. 



ALL ADDRESSES ARE REAL. 




Serviceability Aids. 2.95 



Trace Routines 

SDAIDS 



1I60A READY FOR COMMUNICATIONS. 

batch f2 

assgn &vs I st i-x'OOe f _ 

// exec <> d<a i d 

4C55D GIVE SPACE FOR SDAID = 

•10k 

4C56E INSUFFICIENT SDAID SPACE* REALLOCATE 

1I00A READY FOR COMMUNICATIONS. 

map 

AREA K-REAL UPPER LIMIT K-VIRT UPPER LIMIT 



/t9 



\ SDA/D 4a**c&/b 






NAME 



F2 SP 92K 

F2 BG V5A 30K 

F2 F4 14 10K 

F2 F3 13 10K 

F2 F2 V2A 14K 

F2 Fl II 82K 

F2 SVA 

F2 VIS 

F2 PP 18K 

F2 allocr f lr-14k ^ ^- 

F2 // exec sdaid * 

F2 4C55D GIVE SPACE FOR 

F2 10k 

F2 4C58D OUTPUT DEVICE 



4C60D STOP ON EVENT 

4C61D EVENT LIMITS = 
x '040000' *x'050fff ' 
4C59D OUTCL = 



94207 
124927 
135167 
145407 
159743 
243711 



262143 



292K 
80K 
80K 
100K 
120K 
96K 
68K 



262144 
561151 
643071 
724991 
827391 
950271 
1048575 
1048575 



KENSLOOP 



NO NAME 



\ MAP 4*»v»u*rt4( 



SDAID 



4C62D 

Yes 

4C63D 

Yes 

4C64D 



EVENT BR = 



EVENT IF 



EVENT SA 






4C65D EVENT GA = 

x' 345678' 

4C66D EVENT TE = 



4C67D EVENT PGMCHK 



4C68D EVENT PAGENQ 



4C69D EVENT PAGEHDL 



£v&xm' ^WcteeO St 



4C57E 
1I00A 



SDAID SUCCESSFULLY INITIATED 
READY FOR COMMUNICATIONS. 



SDAREA=0010K 









DC 9 



SDfllD -6e&uv> ^«<*Tte ( ?&z&2' 



j00040000l ^OOOSOFFfI 00000000 00000000 C2000000 00000200 80400040 
FFFFFFFF /FFFFFFFF 00000000 00000000 00000000 00000000 OOOOFFFF 



OR // X'b' -ar+uGu+tt uix, tdJur e^ctU J&^+w 

C/Z/OX'A' - ><- -~-4L«>*f -* - 

C£ J _ „ _ _ „ _ ev ^Jt (S* +/F+ <?/t) 



AC A 
10004043C 



I000404EA1 



DC 9 _ 

D0001F80 1 0004043CL , <Q0047)4E?n r 00000000 00000000 C2000000 00000200 80400040 
O000F600 FFFFFFFF YFFFFFFFF^ 00000000 00000000 00000000 00000000 OOOOFFFF 



F2 



CU I000464EfrL. 00 
c j FFFFFFFF "A 00 






Sl>A'6 



AC 9 
00000000 



CXr/ C/l f & £Z*i yg/ e t x*t^ / esK**fuf &*«//*r"CM 



The example above shows the operator-system dialogue on a 3215 PRKB during SDAID initialization. 

After initialization the contents of the control registers have been changed to alter event limits 
and traces. 






2.96 Serviceability Aids. 



o 



Trace Routines 

SDAIDS 



IF GA 

GPR 0-7 

GPR 8-F 

CTL 0-7 

CTL 8-F 

LOW CORE 

00000000 

00000020 

00000040 

00000060 

00000080 

0O00OOA0 

ooooooco 



C o 00*04 3£ > TOD MICSEC 

00000000 OOD2FOO0 00000030 

00000001 00000B33 OOOOOOOF 
004000FF OO0OE640 FFFFFFFF 
OOOOFFFF D0001F80 0004043C 



2333024913754652 

00000000 00000000 
4004007A 0004107A 
FFFFFFFF 00000000 
000404EA 00000000 



PSW AT TIME OF EVENT 471D00000004043E INSTR 11233ft 780B3CE 
OOOOOOBE 00000010 00000002 
07C8C1E2 B0040426 000422F8 
00000000 00000000 00000000 
00000000 C2000000 00000200 



A. T* 3. 3 



00000 00000000 



00000000 00000000 00000000 
471D3000 0004043A 47100000 
00000000 04000000 10003B70 
440C0000 OOOOOBCC OOOCOOOO 
00000540 00000080 0002000A 
C £» 00000 20000060 

SEGM TABLE/ 0OO0E6 40 

0000E640 ,'F00" aE330l FO0QE370 FOO0E3B0 

0OOOE660 >"o66E530\FO00E570 F000E5B0 

PAGE TABLES 0OO0E330 

0OOOE320 -0000000 00000000 00000000 

0OO0E340 

000 OE 360 

OOOOE380 

0OOOE3AO 

0O0OE3C0 

0000E3E0 

0000E400 

OO00E420 

0000E440 



00000000 
0004043E 
00000000 
0003BOOO 
00020080 
000002CO 
00000000 



FOOOE3F0 
FOOOE5F0 



^Ite^r 



00400048 00500058 00600068 00700078/ 
00COO0C8 00000008 00E000E8 00F000F8 V 
01400148 01500158 01600168 80118011 
80118011 80118011 80118021 80218021 
80418041 80418041 80418041 80518051 
80018001 80018001 80018001 80018001 
80018001 80018001 80018001 80018001 
03C103C9 03D10309 03E103E9 03F103F9 
00150015 00150015 00150015 00150015 
— SAME— 

00150015 00150015 00150015 00150015 
00250025 00250025 00250025 00250025 
— SAME — 

00250025 00350035 00350035 00350035 
00350035 00350035 00350035 00350035 
00350035 00350035 00350035 00350035 
00450045 00450045 00450045 00450045 
— SAME — 

00450045 00450045 00450045 00450045 
00550055 00550055 'A ~ £* '50055 

—same— rage./y O 

OOOOE620 00550055 00550055 X f i50055 

PAGEFR TAB O0O00E88 L . . . 

00000E80 000 0000 000000 83 Jo0020000_ OOOOOQpp.' 
00020000 00030000 00020000 00040000 
00020000 00070000 00020000 00080000 
00020000 OOOBOOOO 00020000 OOOCOOOO 
00020000 OOOFOOOO 00020000 00100000 
00020000 00130000 00020000 00140000 
00020000 00170000 00020000 00180000 
00020000 001B0000 00020000 OOICOOOO 
00020000 001FOOOO 00020000 00200000 
00020000 00230000 00020000 00240000 
00020000 00270000 00020000 00280000 
00020000 00260000 00020000 002C0000 
00000418 00800188 000001A8 FFFF0190 
00000410 008301AO 00000198 00820170 
OOOOOICO FFFF01B0 000001C8 FFFF01B8 
000001EO FFFF0100 000001E8 FFFF01D8 
00000200 FFFF01F0 00000208 FFFF01F8 
00000220 FFFF0210 00000228 FFFF021B 
00000240 FFFF0230 00000248 FFFF0238 
00000260 FFFF0250 00000268 FFFF0258 
00000280 FFFF0270 00000288 FFFF0278 
000002A0 FFFF0290 000002A8 FFFF0298 
000002C0 FFFF02B0 000002C8 FFFF02B8 
000002EO FFFF02D0 000002E8 FFFFO208 
00000300 FFFF02F0 00000308 FFFF02F8 
00000320 FFFF0310 00000328 FFFF0318 
00000340 FFFF0330 00000348 FFFF0338 
00000360 FFFF0350 00000368 FFFF0358 
00000380 FFFF0370 00000388 FFFF0378 
000003A0 FFFF0390 000003A8 FFFF0398 
000303C0 007703A8 000303C8 007803A8 
00030190 007B03E0 00030190 007C03E8 



0OOOE4A0 
0O0OE4C0 

O0O0E50O 
0000E520 
0OO0E540 
0000E560 

0OO0E5A0 
0O00E5C0 



OOOOOEAO 
OOOOOECO 
OOOOOEEO 
OOOODFOO 
0OO0DF2O 
00O0OF40 
00O0DF60 
O0000F80 
OOOOOFAO 
OOOODFCO 
OOOOOFEO 
OOOOEOOO 
OOOOE020 
00O0EO4O 
O0O0E060 
0OO0E08O 
OOOOEOAO 
OOOOEOCO 
OOOOEOEO 
OOOOE100 
O00OE120 
0O0OE14O 
00OOE160 
0OOOE180 
OOOOEIAO 
O0OOE1CO 
O00OE1E0 
0OOOE2O0 
0OOOE220 
OOOOE240 
O0OOE26O 



00000000 
00000000 
00B62900 
04080000 
12042003 
00000000 
00000000 



000004A0 470F2000 0000090C 

0003B174 47100000 0004044A 

02FDB4D4 44OC0000 0O0O0C14 

0000D13A 440COOOO OOOOOBIO 

00025000 0004043C OOOOOICC 

00000100 00000009 00000000 

00000000 00000000 00000000 



$a$^'<&vv> PtqeT/16 



F000E430 F000E470 FOO0E4B0 F000E4FO 

oooooooi oooooooi oooooooi 0000000 



j / S e ?w&"^~ 



i.U.O.U.O.UO 



|000gp008 00100018 00200028 00300038 

►was -^900098 O0A000A8 00B000B8 

-/^OOX, O 100118 01200128 01300138 

<7 118011 80118011 80118011 

80218021 80318031 80318031 80318041 

80518051 80518051 80518001 80018001 

80018001 80018001 80018001 80018001 

80018001 80018001 80018001 03B103B9 

01790171 01A10199 01890015 00150015 

00150015 00150015 00150015 00150015 

00150015 00250025 00250025 00250025 

00250025 00250025 00250025 00250025 

00350035 00350035 00350035 00350035 

00350035 00350035 00350035 00350035 

00350035 00450045 00450045 00450045 

00450045 00450045 00450045 00450045 

00450045 00450045 00550055 00550055 

00550055 00550055 00550055 00550055 

OOOOOOOO 00000000 00000000 00000000 



00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00000178 
00000180 
00000100 
000001FO 
00000210 
00000230 
00000250 
00000270 
00000290 
000002BO 
00000200 
000002 FO 
00000310 
00000330 
00000350 
00000370 
00000390 
00000400 
00030300 
00030190 



00010000 
00050000 
00090000 
OOOOOOOO 
00110000 
00150000 
00190000 
00100000 
00210000 
00250000 
00290000 
00200000 
00840418 
FFFF0180 
FFFF01C0 
FFFF01E0 
FFFF0200 
FFFF0220 
FFFF0240 
FFFF0260 
FFFF0280 
FFFF02A0 
FFFF02C0 
FFFF02E0 
FFFF0300 
FFFF0320 
FFFF0340 
FFFF0360 
FFFF0380 
FFFF03A0 
007903A8 
007D0188 



00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
000001A0 
00000180 
000001B8 
000001D8 
000001F8 
00000218 
00000238 
00000258 
00000278 
00000298 
0O0002B8 
00000208 
000002 F8 
00000318 
00000338 
00000358 
00000378 
00000398 
000303B8 
00030400 
00030198 



.2.1.9 



I: 



00060000 

OOOAOOOO 

OOOEOOOO 

00120000 

00160000 

001A0000 

001EOOOO 

00220000 

00260000 

002A0000 

00810410 

FFFF0400 

FFFF01A8 

FFFF01C8 

FFFF01E8 

FFFF0208 

FFFF0228 

FFFF0248 

FFFF0268 

FFFF0288 

FFFF02A8 

FFFF02C8 

FFFF02E8 

FFFF0308 

FFFF0328 

FFFF0348 

FFFF0368 

FFFF0388 

007603A8 

007A03A8 . 

007E03F8 J 



>/2*e, /v«a 



/<&£- fra*ne~ 



(£x 3o Kr)\ 



An example of dumping the page tables and low address storage on an event. 







Serviceability Aids. 2.97 



Trade Routines 

SDAIDS 



r 



EVENT ADDR OR PAGE ADOR 
NC-CLASS +CODE 
EVENT-ID PSW 

TE 050000 471D200O0O0410EE 
TE 04F800 471D2000000410EE 
TE 04FOOO 471D2000000410EE 
TE 04E800 471D2000000410EE 
TE 04E000 471D2000000410EE 
TE 04D800 47102000000410EE 
TE 0*0000 471020000004144C 
TE 060800 47102000000422C8 
TE 042800 471D1000000406EA 



TOD DEC MIC SEC 
2333039363651268 
2333039363711212 
2333039363794504 
2333039363852338 
2333039363912247 
2333039363969936 
2333039364088211 
2333039407337972 
2333039407342990 



EVENT MASKING 
PER LIMITS 

E GPRS LOWER UPPER 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 



GPR 13 
000402EO 
000402EO 
000402E0 
000402EO 
000402E0 
000402E0 
000402EO 
F6041E28 
F0040D78 



GPR 14 
8004 108C 
8004 108C 
8004 108C 
8004108C 
8004108C 
8004108C 
80041414 
800405A6 
A004112E 



GPR 15 
00041AF4 
00041AF4 
00041AF4 
00041AF4 
00041AF4 
00041AF4 
00041AF4 
900417EC 
8004 11 4C 



EVENT PGM CHK INTERRUPT TOO MICSEC 



00000018 00040910 00000021 
00000000 00000000 00000000 
004000FF 00OOE640 FFFFFFFF 
OOOOFFFF 00000000 00000000 



GPR 0-7 
GPR 8-F 
CTL 0-7 
CTL 8-F 
LOU CORE 

00000000 00000000 00000000 00000000 

00000020 47100000 000422DC I471D3000 0004071 

00000040 1000E718 08000000 1000E710 

00000060 

00000080 

OOOOOOAO 

OOOOOOCO 



440COOOO OOOOOBCC OOOCOOOO 
00000S40 00000000 00020007 
00000000 00000000 20000060 
00000000 00000000 00000000 
— SAME — 
SUPERVISOR 
00000120 00000000 00000000 00000000 00000000 

— SAME — 
000004AO F1F261F0 F661F7F3 70007000 00000000 
000004C0 00060FFF 0004232F 0004232F 00000010 
000004EO 41044296 42974389 3F003F06 3F0C38F1 
00000500 46300000 3DCC3E4C 3EBC0010 00000000 
00000520 00000000 04A010EO 00000588 COC00340 
00000540 00006140 00002ECA 080407CO 00004134 
00000560 00017000 08005DE6 0032002C 00050000 
00000580 60800800 000008FC 00009260 00005F78 
000005AO 00000000 00007998 00006360 00003854 



2333039515946093 PSW AT TIME OF EVENT 471D3000000.4. 

00000002 0000002E 00000000 00000000 00000000 

4004007A 0004107A 07C8C1E2 A00406EE 000422A0 

FFFFFFFF 00000000 00000000 00000000 00000000 

OOFFFFFF 00000000 00009000 C2000000 00000200 

^- /^a *cA*zJt. ot.6 />sw 

OOOOOOOOX OOOOOOpy 000004AO 40000000 00000000 
00000000 0003E974 470C2000 0000090C 
FC4F0500 023E32C0 440C0000 00000C14 
04080000 0000D13A 440C0000 00000810 
12042003 00020000 00000000 000001CC 
00000000 00000100 OOOOOOOE 00000000 
00000000 00000000 00000000 00000000 



00000000 

0O03E8O0 

507 

ooooo 

00000000 



GPR GPR 1 GPR2 
00000002 OOOOE003 0004102A 
00000002 0000E50A 00041E84 
00000002 000ODD06 00041F04 
00000002 0000D506 00042138 
00000002 OOOOC004 00042250 
00000002 0OOOC5O2 0004235C 
00000002 00008051 0004245E 
00000080 00040B1A 000403F4 
00040078 0004081A 00000001 

INSTR <£Ejb3C676C5EC 

-* 6 



?°y z 



ZEn*4iuiJcm s&*v&tXT~i<i}edi^ • 



00000000 00000000 00000000 00000000 

00000000 00000000 C2E4C707 D9C7C3D2 12/06/73 .BUGPRGCK 

OOOBFFFF FD7FCED3 3OAOCED0 002E40FD ......L 

F2F0F6F7 F3F3F4F0 00003CD4 0000003C 120673340. .. N. .. . 

00008090 00007118 00003864 3BD45A30 . M. . 

40404040 40404000 40404040 40404000 

000026C4 00004888 00005854 000082E8 ../ V 

0000700C 00000000 00008299 00006088 W -. 

00006068 000060CO 00000010 000074B0 - -...-. 

00000638 00008099 00004246 00000760 - - far x 



An example showing the output to device X'OOE' (a line printer) after specifying 
a "dump on program check" and a page translation exception trace using output 
class FASTREC, AUTOMATIC 

Notice that the SD buffer is dumped before the dump of the supervisor and real 
storage. (A system dump would follow the SDAID dump if it was requested, refer to 
A- 2 in this Section for a description of the system dump.) 



"BR IF 
GP* 0- 
GPR 8- 
CTL 0- 
CTL 8- 
L3W CORE 
00000000 
00000020 
00000040 
00000060 
00000080 
OOOOOOAO 
OOOOOOCO 



000400C6) TOO MICSEC 
0033DO03 000404E8 00003FE0 
80041088 00041084 40041032 






2327688745012422 
000407A1 00003004 
00040088 00041888 
FFFFFFFF 00030000 
00040660 OOOOOOOO 



PSW 470D000000040E78 I NSTR .47F0BDF0 



00008CA0 OCOOOOOO 00003860 
440:0000 00000C4E OOOCOOOO 
00393540 00000080 00020040 
OOOOOOOO OOOOOOOO 20000060 
OOOOOOOO OOOOOOOO OOOOOOOO 
--SAME — 
COMREG LOC 000004AO 
000004AO F1F061F0 F561F7F3 70007000 
000004CO 00088FFF 00042D1B OOOOOOOO 
000004EO 3F3841A6 41 A7 4299 3DD03DD6 
00000500 45400000 3B9C3C1C 3C8C0010 
00000520 OOOOOOOO 04A010E0 00000588 
00000540 000063E8 00002BFE 083607F0 
00000560 00017000 0700608E 0032002C 
SYSCOM LOC 00000540 
00000540 000063E8 00002BFE 083607FO 
00000560 00017000 0700608E 0032002C 
00000580 60800840 00000952 00009488 
C00005A0 0000063C 00007D40 00006608 
000005CO 00003156 OO00A264 00 0006E4 
000005EO 00081018 00200000 OOOOOOOO 
00000600 OOOOOOOO OOOOOOOO OOOOOOOC 
00000620 00006680 OOOOOOOO 00002972 
00000640 OOOOOOOO OOOOOOOO 00003CD0 



OOOOOOOO 
00043E78 
OOOOOOOO 
O003B000 
00040380 
000002CO 
OOOOOOOO 



OOOOOOOO 
00303010 
30DC38F1 
00003300 
COC00740 
00004000 
00050000 

00004000 
00053000 
0000622 
00003594 
OOOOOOOO 
OOOOOOOO 
01710001 
0003FFFF 
OO0O38C6 



OOOOOOOO 
00003000 
FD083E00 
04080000 
12042803 
OOOOOOOO 
OOOOOOOO 



O00OOO01 00000006 80041BOO 
00042888 000004AO 00000540 
OOOOOOOO OOOOOOOO OOOOOOOO 
OOOOOOOO C2000000 00000200 

000004A0 471D1000 0004047A 
OOOOOOOO 470F2000 00000962 
02583606 440COOOO O0OO0CC8 
0003B188 440C000O 00000892 
OO02C000 000400C6 000001:8 
00000100 00000130 OOOOOOOO 
OOOOOOOO OOOOOOOO OOOOOOOO 



OOOOOOOO 
OOOFFFFF 
F0F0F5F7 
000084BC 
40404040 
00009AOO 
000072B4 

00009AOO 
000072B4 
00006310 
0O00OS6O 
0000D960 
OOOOOOOO 
0000F600 
000086C8 
OOOOOOOO 



OOOOOOOO 02C50561 E3D604E2 
FD7FFED3 3000FEDO OOC63F01 
F3F2F7F8 00003AA4 0000003C 
000074B8 000035A4 39A45C04 
4040400Q 4040 4040 40404000 
00004798 00005AF8 000087C0 
OOOOOOOO 0000876A 00006360 



00004798 
OOOOOOOO 
00006368 
000084C5 
00009088 
000036 72 
0000ED38 
AOOE8000 
OOOOOOOO 



00005AF8 
0303876A 
00000010 
0000414A 
00003838 
OOOOOOOO 
0000F160 
OOOEFOOO 
000006B0 



00O087C0 
00006360 
00007850 
00000790 
OOOOOOOO 
OOOOOOOO 
00006620 
OOOOOOOO 
07241D54 






Coufa, 
Off OH -n&xl~ 



ew»£ BR a^ I F. 

10/05/73 KEN/TOMS 

L F.J 

.Q 0... 100573278 



(gxtTxr) 



An example of dumping the active communication region and low address 
storage on an event. 



2.98 Serviceability Aids. 



Trace Routines 

SDAIDS 



o 



o 

























A // JOB DEBUGEX1 

• // OPTION NODECK.LIST, 
// EXEC ASSEMBLY 

• PAGENQ PAGE 00040800 


XREF, LINK, LOG. OUNP 

KEY 1 TASKID 1 


REQUID 03 


OATE 
TFIX 


2/06/73, CLOCK 11/49/33 


y- 






A PAGEHOL 


PAGE 00040800 


FRAME 


00018800 KEY 1 TASKID 1 


REQUID 03 


TFIX 


&u**i , 






PAGENO 


PAGE 00041000 




KEY 1 TASKID 1 


REQUID 03 


TFIX 




<Z*KX 






• PAGEHDL 


PAGE 00041000 


FRAME 


00019000 KEY 1 TASKID 1 


REQUID 03 


TFIX 








^ PAGENO 


PAGE 00041800 




KEY 1 TASKID 1 


REQUID 03 


TFIX 


L*« d? 






PAGEHDL 


PAGE 00041800 


FRAME 


00019800 KEY 1 TASKID 1 


REQUID 03 


TFIX 


cuistrtet, &n / 


WAOptMb, 






• PAGENQ 


PAGE 00042000 




KEY 1 TASKID 1 


REQUID 03 


TFIX 




V 






A PAGEHOL 


PAGE 00042000 


FRAME 


0001AOOO KEY 1 TASKID 1 


REQUID 03 


TFIX 










PAGENQ 


PAGE 00042800 




KEY 1 TASKID 1 


REQUID 03 


TFIX 










• PAGEHDL 


PAGE 00042800 


FRAME 


00018000 KEY 1 TASKID 1 


REQUID 03 


TFIX 










m PAGENO 


PAGE 00043000 




KEY 1 TASKID 1 


REQUID 03 


TFIX 










PAGEHDL 


PAGE 00043000 


FRAME 


00017800 KEY 1 TASKID 1 


REQUID 03 


TFIX 










• PAGENO 


PAGE 00043800 




KEY 1 TASKID 1 


REQUID 03 


TFIX 










A PAGEHDL 


PAGE 00043800 


FRAME 


0001A800 KEY 1 TASKID 1 


REQUID 03 


TFIX 










PAGENO 


PAGE 00044000 




KEY 1 TASKIO 1 


REQUID 03 


TFIX 










• PAGEHDL 


PAGE 00044000 


FRAME 


0001BOOO KEY 1 TASKIO 1 


REQUID 03 


TFIX 










^ TE PAGE 


ADDR 0005D000 


TOD 


MICSEC 2333011788410161 


PSW AT TIME OF EVENT 


471D200000041632 INSTR 92FF2002943F 








PAGENQ 


PAGE 00O5D0O0 




KEY 1 TASKID 1 


REQUID 10 


TE 










• PAGEHDL 


PAGE 00050000 


FRAME 


0001B800 KEY 1 TASKID 1 


REQUID 10 


TE 










~ TE PAGE 


AODR 0005F000 


TOD 


MICSEC 2333011788621154 


PSW AT TIME OF EVENT 


471D00000004166E INSTR 0706A000A000 








PAGENQ 


PAGE 0005FOOO 




KEY 1 TASKID 1 


REQUID 10 


TE 










• PAGEHDL 


PAGE O0O5F0O0 


FRAME 


OOOICOOO KEY 1 TASKID 1 


REQUID 10 


TE 










— TE PAGE 


ADDR 0005F800 


TOD 


MICSEC 2333011790227387 


PSW AT TIME OF EVENT 


471D300000040644 INSTR 0EE00501D686 








PAGENQ 


PAGE 0005F800 




KEY 1 TASKID 1 


REQUID 10 


TE 










• PAGEHDL 


PAGE 0005F8O0 


FRAME 


0001C800 KEY 1 TASKIO 1 


REQUIO 10 


TE 










^ TE PAGE 


ADDR 00060000 


TOD 


MICSEC 2333011793770641 


PSH AT TIME OF EVENT 


4710300000040644 INSTR 0EE00501D686 








PAGENQ 


PAGE 00060000 




KEY 1 TASKIO 1 


REQUID 10 


TE 










• PAGEHDL 


PAGE 00060000 


FRAME 


0001DOOO KEY 1 TASKID 1 


REQUID 10 


TE 










_ TE PAGE 


ADDR 00060800 


TOD 


MICSEC 2333011796139258 


PSW AT TIME OF EVENT 


471D300000040644 INSTR 0EE005010686 








PAGENQ 


PAGE 00060800 




KEY 1 TASKID 1 


REQUID 10 


TE 










• p'agehol 


PAGE 00060800 


FRAME 


0001D800 KEY 1 TASKID 1 


REQUID 10 


TE 




Ce*z?KT)\ 

























An example of SDAID page tracing during an assembly job. 



































EVENT AOOR OR PAGE ADDR 








EVENT MASKING 














• MC-CLASS *C0DE 






PER 


LIMITS 














EVENT-ID 


PSW 


TOO DEC MICSEC 


TE 


GPRS 


LOWER 


UPPER 


GPR 13 


GPR 14 


GPR 15 


GPR 


GPR 1 


GPR2 


_ TE 


043000 


470000000004 1C62 


2333035396598690 


Y 





0000 


000000 


FFFFFF 


00042888 


000004AO 


00000760 


00000003 


00003FOC 


0000410C 


• TE 


05D000 


4710200000041632 


2333035416187226 


Y 





0000 


000000 


FFFFFF 


000402E0 


00O414F8 


00060FFE 


80041934 


00040C2Q 


00050507 


TE 


05F000 


471D00000004166E 


2333035416192369 


Y 





0000 


000000 


FFFFFF 


000402EO 


80041646 


0005F255 


80041934 


00040C20 


00040A7F 


A TE 


05F800 


4710300000040644 


2333035417576315 


Y 





0000 


000000 


FFFFFF 


00040 2E0 


0005F7FD 


00000019 


0005F255 


00000019 


00040B39 


• TE 


060000 


4710300000040644 


2333035420950387 


Y 





0000 


000000 


FFFFFF 


000402EO 


O0O5FFEA 


0000001F 


0005F255 


0000001F 


0004 0B3F 


TE 


060800 


4710300000040644 


2333035423146414 


Y 





0000 


000000 


FFFFFF 


00040 2E0 


000607F4 


0000003F 


0005F255 


0000003F 


0005F289 


_ TE 


059800 


471D200000041E2C 


2333035449944730 


Y 





0000 


000000 


FFFFFF 


000402EO 


00040F58 


0005F255 


00040 A 7C 


00059B41 


0000 1C7E 


• TE 


057800 


471020000004 1E6E 


2333035449949477 


Y 





0000 


000000 


FFFFFF 


000402EO 


00040F58 


0005F255 


00040A7C 


00001C7E 


00059B32 


TE 


05B800 


47 10300000040644 


2333035453007449 


Y 





0000 


000000 


FFFFFF 


000402EO 


0005B7EE 


00000039 


0005D447 


00000039 


00000004 


m. TE 


05C000 


4710300000040644 


2333035453671223 


Y 





0000 


000000 


FFFFFF 


000402EO 


0005BFF6 


00000021 


00050447 


00000021 


00000005 


• TE 


05C800 


471D300000040644 


2333035454009747 


V 





0000 


000000 


FFFFFF 


000402EO 


0005C7CA 


00000046 


0005D447 


00000046 


00000005 


TE 


050800 


47102000000410EE 


2333035623279245 


Y 





0000 


000000 


FFFFFF 


000402EO 


8004108C 


00041AF4 


00000002 


0000F504 


00041B04 


A TE 


050000 


47102000 00 0410EE 


2333035623336942 


Y 





0000 


000000 


FFFFFF 


000402EO 


8004 10 8C 


00041AF4 


00000002 


OOO0E003 


0004 102A 


• TE 


04F800 


471D2000000410EE 


2333035623396991 


Y 





0000 


000000 


FFFFFF 


00040 2E0 


8004108C 


00041AF4 


00000002 


0000E50A 


00041E84 


TE 


04F00O 


47102000000410EE 


2333035623480401 


V 





0000 


000000 


FFFFFF 


000402E0 


8004 108C 


00041AF4 


00000002 


00OOOD06 


00041F04 


_ TE 


04E800 


47102000000410EE 


2333035623538305 


Y 





0000 


000000 


FFFFFF 


000402E0 


8004108C 


00041AF4 


00000002 


0000D506 


00042138 


• TE 


O4E0OO 


471D20000004 10E E 


2333035623598321 


Y 





0000 


000000 


FFFFFF 


000402EO 


8004 108C 


00041 AF4 


00000002 


0000CD04 


00042250 


TE 


04D800 


471020000004 10EE 


2333035623656083 


Y 





0000 


000000 


FFFFFF 


000402E0 


8004 108C 


00041AF4 


00000002 


00OOC5O2 


0004235C 


A TE 


O4D0OO 


471 020000004 144C 


2333035623774539 


Y 





0000 


000000 


FFFFFF 


000402EO 


80041414 


00041AF4 


00000002 


0000BD51 


0004245E 


• TE 


060800 


47102000000422C8 


2333035667085247 


Y 





0000 


000000 


FFFFFF 


F6041E28 


800405A6 


900417EC 


00000080 


00040B1A 


000403F4 


TE 


042800 


47101000000406EA 


2333035667090270 


Y 





0000 


000000 


FFFFFF 


F0040078 


A004112E 


80041 14C 


00040078 


00040B1A 


00000001 


A TE 


043000 


470D000000041C62 


2333035783718692 


Y 





0000 


000000 


FFFFFF 


00042888 


000004AO 


00000760 


00000003 


00003FOC 


0000410C 


• SOBUFFER ENO 
























(GtZtxt 



OA dump of the SD buffer after executing a page trace (TE) using the FASTREC 
output class. (The SD buffer is dumped on termination of SDAID). 




Serviceability Aids. 2.99 



Trace Routines 

SDAIDS 





































m IF GA 


000404 3C 


TOO 


IUCSEC 2333012672382809 


PSW 


AT 


TIME 


OF 


EVENT 


471D00000004043E 


INSTR 


12334780B3CE 






BRIF 


0004043E 


TOO 


MlYsEC 2333012672458551 


PSH 


AT 


TIME 


OF 


EVENT 


4710000000040448 


INSTR 


4780B3CE0630 








• IF GA 


P0040448 


TOD 


MICIEC 2333012672534442 


PSW 


AT 


TIME 


OF 


EVENT 


47100 0000004044A 


INSTR 


12444780B30A 








_ BRIF 


0004044Ajl 


TOO 


MICSIC 2333012672610919 


PSM 


AT 


TIME 


OF 


EVENT 


471D000000040454 


INSTR 


4780B30A0640 








IF GA 


00040454 \ 


k TOO 


HICSe\ 2333012672685341 


PSW 


AT 


TIME 


OF 


EVENT 


4710200000040456 


INSTR 


12554730B3E6 








• IF 


00040456 


\oo 


MICSfcc\ 2333012672761969 


PSH 


AT 


TIME 


OF 


EVENT 


471D20000004045A 


INSTR 


4780B3E60650 








_ IF GA 


0004045A 


TOO 


MICSEC \2333012672838460 


PSW 


AT 


TIME 


OF 


EVENT 


471020000004045C 


INSTR 


065047F0B3C2 








BRIF 


O004045C 


TOD* 


^UCSfcC 1333012672913531 


PSW 


AT 


TIME 


OF 


EVENT 


471020000004045C 


INSTR 


47F0B3C21266 








• IF GA 


0004043C 


TOO 


MICSEC 2*33012672990157 


PSW 


AT 


TIME 


OF 


EVENT 


471D00000004043E 


INSTR 


12334780B3CE 








m BRIF 


C004043E 


TOO 


MliWc 23B3012673065877 


PSW 


AT 


TIME 


OF 


EVENT 


4710000000040448 


INSTR 


4780B3CE0630 








IF GA 
• BRIF 
m IF GA 


00040448 

0004044aV 

01040454 


TOD 
TOD 
Tb« 


MICSEC 2 3 3B0 126 73 140296 
MICSe\ 2331012673216921 
MI CSEc\ 2 »3 3» 1267329 3403 


PSW 
PSW 
PSw 


AT 
AT 
AT 


TIME 
TIME 
TIME 


OF 
OF 
OF 


EVENT 
EVENT 
EVENT 


471D00000004044A 
4710000000040454 
471D200000040456 


INSTR 
INSTR 
INSTR 


12444780b3DA 


BZ cueflu 5 
MR 5,5 




4780B3DH(0640 


[1255J4780B3E6 




IF 


00040456 


TOO 


HT\SEC \333dl2673368510 


PSw 


AT 


TIME 


OF 


EVENT 


471020000004045A 


INSTR 


47B0B3E6to650 


0Z ClEAHL 






• IF GA 
_ BRIF 


0004045A 
0004045C 


TOO 
TOO 


HICSeV 2\33012673445n86 
HI \ \ \ ' 8 


PSW 

PSw 


AT 
AT 


TIME 
TIME 


OF 
OF 


EVENT 
EVENT 


471D200O0004O45C 
471020000004043C 


INSTR 
INSTR 


l 0650|47FOB3C2 


BctR fro 
ccem -i 




47F0B3C2|1266 




IF GA 


000404 3C 


TOO 


HI ^M - 

^"/y^/a^t , 


PSw 


AT 


TIME 


OF 


EVENT 


471D00000004043E 


INSTR 


|1233|4780B3CE 


LTR. 3,3 






• BRIF 


0004043E 


TOO 


PSw 


AT 


TIHE 


OF 


EVENT 


4710000000040448 


INSTR 


|4780B3CEJ0630 


Sz CiCfiUcf- 






_ IF GA 


C0040448 


•"^no 


A_ot^ <m 


PSW 


AT 


TIME 


OF 


EVENT 


471D000O0O04O44A 


INSTR 


|12444}780B3DA 


krfi t+.q. 






BRIF 


C004044AJ 


TOO 


Ml / 19 


PSW 


AT 


TIME 


OF 


EVENT 


4710000000040454 


INSTR 


|4 780B30Al0640 


Qz c ceflU 5 






• IF GA 


01041454 


TOO 


hi Zw> adtJt&A »i 


PSW 


AT 


TIME 


OF 


EVENT 


4710200000040456 


INSTR 


12554780B3E6 








_ IF 


03040456 


no 


MI 52 


PSW 


AT 


TIME 


OF 


EVENT 


471020000004045A 


INSTR 


4780B3E60650 








IF GA 


0004045A 


TOO 


MI 31 
MU^/// tfTl&L 16 

r 1 &Ju* °$ " 


PSw 


AT 


TIHE 


OF 


EVENT 


471020000004045C 


INSTR 


065047F0B3C2 








• BRIF 


0104045C 


TOO 


PSW 


AT 


TIME 


OF 


EVENT 


47102000000404 3C 


INSTR 


47F0B3C21266 








_ IF GA 


0^0404 3C 


TOO 


PSw 


AT 


TIME 


OF 


EVENT 


471D00000004043E 


INSTR 


12334780B3CE 








BRIF 


1104043E 


to/ 


HI . . . 96 


PSw 


AT 


TIHE 


OF 


EVENT 


471D000000040448 


INSTR 


4780B3CE0630 








• IF GA 


10040448 


Jo 


PSw 


AT 


TIME 


OF 


EVENT 


471D00000004044A 


INSTR 


12444780B3DA 








m BRIF 


0004044 AJ 


TOO 


HICSEC 23330126744 30955 


PSw 


AT 


TIME 


OF 


EVENT 


4710000000040454 


INSTR 


4780B3DA0640 










IF 


01040454 


TOO 


MICSEC 2333012879517750 


PSW 


AT 


TIME 


OF 


EVENT 


4710200000040456 


INSTR 


125547808 3E6 










• IF 


("1040456 


TOD 


MICSEC 2333012879592055 


PSw 


AT 


TIME 


OF 


EVFNT 


471020000004 045A 


INSTR 


4780B3E60650 










• IF 


0014145A 


TOD 


MICSEC 2353012879663631 


PSW 


AT 


TIHE 


OF 


EVENT 


471020000004045C 


INSTR 


065047FOB3C2 










BRIF 


0004045C 


TOD 


Hir*.fC 731301 2R79745185 
M RJdtV* <"/■/: ,57 


PSW 


AT 


TIHE 


OF 


EVENT 


471D20000004043C 


INSTR 


47F0B3C21266 










• IF 


0O04043C 


TOD 


PSW 


AT 


TIHE 


OF 


EVENT 


471D00000004043E 


INSTR 


1233478063CE 


/2 








_ SRIF 


0004043E 


TOO 


PSW 


AT 


TIHE 


OF 


EVENT 


4710000000040448 


INSTR 


4780B3CE0630 


/?/c -t- 












I = *>*m - z 










' 








/F 






IF 


00040448 


TOD 


PSW 


AT 


TIME 


OF 


EVENT 


471000000004044A 


INSTR 


12444780B3DA 






• BRIF 


00040440 


TOO 


m -*£121L. , 5I 


PSW 


AT 


TIME 


OF 


EVENT 


4710000000040454 


INSTR 


4780B3DA0640 


7rtK£-~ 






m IF 


00040454 


TOO 


PSW 


AT 


TIME 


OF 


EVENT 


471D200000040456 


INSTR 


12554780B3E6 










IF 


00040456 


TOO 


PSW 


AT 


TIHE 


OF 


EVENT 


471020000004045A 


INSTR 


4780B3E60650 










• IF 


0004045A 


TOO 


M ■fouc&T' '■" 


PSW 


AT 


TIME 


OF 


EVENT 


471D20000004045C 


INSTR 


065047F0B3C2 










m BRIF 


0004045C 


TOD 


MlCbtC 233301288035 J883 


PSW 


AT 


TIHE 


OF 


EVENT 


471D20000004043C 


INSTR 


47F0B3C21266 










IF 


000404 3C 


TOO 


MICSEC 2333012B80427507 


PSW 


AT 


TIHE 


OF 


EVENT 


471000000004043E 


INSTR 


12334780B3CE 










• BRIF 


0004043E 


TOO 


MICSEC 2333012880501878 


PSW 


AT 


TIME 


OF 


EVENT 


4710000000040448 


INSTR 


4780B3CE0630 




f (& 3/ KT) 



































o 
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This example shows an SDAID BR, IF and GA trace used to trace a loop using 
output class PSW. 

The GA trace was "taken off" by changing the contents of control register 9, and the 
programmers remarks on this example show how the information is interpreted. 
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2.100 Serviceability Aids. 



Section 2-C 
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Library Display Programs and Utilities 
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SYSVIS dump Utility Program 2.125 

Restrictions 2.125 
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How to execute 2.126 
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When to execute 2.130 
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Serviceability Aids. 2.101 



Library Display Programs and Utilities 

LSERV 



The label information cylinder is on the first full cylinder after the last system 
library on SYSRES. A display of all labels on the cylinder, with the exception of 
Data Set Secured labels, can be obtained by executing LSERV. Illustrations in this 
section show the location of the label information cylinder on SYSRES, and the 
layout of label information and record format. 



System requirements 

LSERV may be executed in any partition, with a minimum of 8192 bytes of the 
real or virtual address areas. LSERV assumes that the SYSRES label cylinder is 
formatted as described in DOS/ VS DASD Labels. 



Executing LSERV 

The control statements necessary to execute LSERV in a virtual partition are: 

From the console: 

// EXEC LSERV 

From the reader: 

// JOB jobname 
//EXEC LSERV 

/* 
/& 

LSERV can also be executed in a real partition. The output of LSERV shows the 
contents of the label cylinder on the device assigned to SYSRES. The output is 
directed to the device assigned to SYSLST. 



When and How to use 

1 . Operator action given in DOS/VS Messages indicates when LSERV must be 
executed. 

Programmer action, also given in DOS/VS Messages, explains how to use the 

LSERV printout. 

For example, under the message: 

0P36NO REC FND 

2. It is useful to execute LSERV prior to running a program that is known to have 
been run sometime in the past, but whose workfile assignments and partition 
allocations are unknown. 

3. LSERV can be used for error analysis. LSERV displays the TLBL and the DLBL 
and EXTENT information contained on the SYSRES label cylinder . Information 
about secured data files is not displayed. 



J 
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Summary of information provided 

The printout of LSERV will show you the following details about the previous run: 

• Whether the correct DLBL/EXTENT information is still on the label cylinder 

• The permanent files 

• The temporary files 

• Extent type 

• File type. 

An example shown at the end of this chapter relates the data printed by the LSERV 
program to the DLBL/EXTENT job control statements. 



2.102 Serviceability Aids. 



The Label Information Cylinder 



Library Display Programs and Utilities 

LSERV 



The label information cylinder contains standard and user label information for 
background and foreground partitions. 

19 tracks on the 3330/3333, 12 on the 3340, or 20 on the 2314/2319 are allocated 
to the label information cylinder. 

The purpose of the label cylinder is to enable label information to be placed in the 
label save areas during program execution. 

Job control stores label information, which is contained in the input job stream, 
on the label cylinder. 

During program execution, label information on the label cylinder is used by the 
OPEN and CLOSE routines. 
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SAMPLE JOB STREAM 

//JOB CATALOG USER PROGRAM 
//OPTION CATAL 

[Object module preceded 1 
by PHASE and INCLUDE] 

1 /* 
// LBLTYPNSD (01) 

2 //EXECLNKEDT 
/& 
// JOB EXECUTE USER PROGRAM 



//DLBL 

// EXTENT 

//DLBL 

// EXTENT 

//TLBL 

// ASSGN 

//ASSGN 

//ASSGN 

// EXEC USER 

/& 



File 1 (Seq. Disk) 



File 2 (Nonseq. Disk) 

File 3 (Labeled Tape) 
File 1 
File 2 
File 3 



Sequence of Events 

1 LBLTYP reserves label area in virtual storage 
for longest label block 

2 Link edit and catalog user phase to core 
image library 

3 Write label information to label cylinder 

4 Assign user files 



Bring program into virtual storage and process 
OPEN/CLOSE 

a. Bring label storage data into virtual storage 

b. Bring file labels into virtual storage 

c. Compare input, create new output labels 



An overview showing how DOS/VS uses 
the label information cylinder. 




SYSRES 



Label 

Information 

Cylinder 



Supervisor 



Seq. 
Disk 



Transient Area 



Label Area 

Nonseq. Disk and Tape 



Background Partition 
USER Program 

Open all 3 

Close all 3 



Virtual 
Storage 
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Library Display Programs and Utilities 
LSERV 



v. 



-W 



NO. 




mMPDMFMT 


STARTING DISK ADDRESS 


NUMBER 
OF TRACKS 

(Allocation) 


R = REQUIRED 




BB 


CC 


HH 


R 


= OPTIONAL 


1 


IPL Bootstrap Record 1 ($$A$IPL1) 


00 


00 


00 


1 


1 


R 


IPL Bootstrap Record 2 ($$A$IPL1) 


00 


00 


00 


2 


R 


Volume Label 


00 


00 


00 


3 


R 


User Volume Label 


00 


00 


00 


4 


O 


2 


System 
Directory 


Record 1 


00 


00 


01 


1 


1 


R 
R 
R 
R 


Record 2 


00 


00 


01 


2 


Record 3 


00 


00 


01 


3 


Record 4 


00 


00 


01 


4 


IPL Retrieval Program ($$A$IPL2) 


00 


00 


01 


5 


R 


3 3 


Core Image Library Directory 


00 


00 


02 




* 


R 


4 


Core Image Library 


00 


End of CI Directory 




* 


R 


X | Y + 1 n 


5 


Relocatable Library Directory 


00 


End of CI Directory 




* 





Z + 1 


00 


6 


Relocatable Library 


00 


End of RL Directory 




* 


O 


X 


Y + 1 


7 


Source Statement Library Directory 


00 


End of RL Directory 




* 


O 


Z + 1 


00 


8 


Source Statement Library 


00 


End of SS Directory 




* 


O 


X 


Y + 1 


9 


Procedure Library Directory 


00 


End of SS Directory 




* 


O 


Z + 1 | 00 


10 


Procedure Library 


00 


End of PL Directory 




* 


O 


X 


Y + 1 


11 




00 


End of P Library 




# 


O 


Label Information Cylinder 


Z + 1 


00 



•Allocation Dependent On User Requirements 
X = Ending CC of the Preceeding Directory 
Y = Ending HH of the Preceeding Directory 
Z = Ending CC of the Preceeding Library 

The location of the label information cylinder on the SYSRES extent 



"%,^ 



C 
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O 



DISK PACK TYPE 



2314 

or 
2319 



TRACK ALLOCATION 
for a 1 , or 2, or 3, partition system. 
(First Full Cylinder after Last Library on SYSRES) 
Track 

BG (USRLABEL) * [ Temporary 

_J Standard (Permanent) 



LSERV 



For a 1 partition system, information on 
tracks 2, 3, 4 and 5 is ignored, and for 
a 2 partition system the tracks for the 
F1 partition follows BG and information 
on tracks 4 and 5 is ignored 



3340 



3330 

or 

3333 




BG (PARSTD) 
F2 (USRLABEL) 
F2 (PARSTD) 



J Temporary 

1 Standard (Permanent) 



F1 (USRLABEL) * | Temporary 



F1 (PARSTD) 



(STD LABEL) 

Standard Labels 

for all 

partitions 



[Standard (Permanent) 
1^ 



Z3 
ZJ 



11 



12 
13 
14 
15 
16 
17 
18 



[Additional Standard Labels! 



19 




> Standard (Permanent) 



V 



O 



TRACK ALLOCATION 
for a 4 partition system 

Track 



TRACK ALLOCATION 
for a 5 partition system 






BG (USRLABEL) 


* I 


1 


BG (PARSTD) | 


2 


F3 (USRLABEL) 


* I 


3 


F3 (PARSTD) 


4 


F2 (USRLABEL) 


* I 






5 


F2 (PARSTD) | 






6 


F1 (USRLABEL) 


* I 


7 


F1 (PARSTD) 


8 


Standard for all | 


9 


Partitions | 


10 




11 




12 




13 




14 


Additional Standard Labels) 


15 




16 




17 




18 




I 


19 





Temporary 
Standard (Permanent) 
Temporary 
Standard (Permanent) 
Temporary 
Standard (Permanent) 
Temporary 
Standard (Permanent) 



/-Standard (Permanent) 



Track 






BG 


(USRLABEL) 


* I 


1 


BG 


(PARSTD) 




2 


F4 


(USRLABEL) 


* I 






3 


F4 


(PARSTD) 








4 


F3 


(USRLABEL) 




5 


F3 


(PARSTD) 








6 


F2 


(USRLABEL) 


* I 


7 


F2 


(PARSTD) 




8 


F1 


(USRLABEL) 




9 


F1 


(PARSTD) 




10 


t 


11 




12 




13 




14 


Additi 


onal Standard Labelsj 


15 








16 




17 




18 




19 









Temporary 

Standard (Permanent) 

Temporary 

Standard (Permanent) 

Temporary 

Standard (Permanent) 

Temporary 

Standard (Permanent) 

Temporary 

Standard (Permanent) 



> Standard (Permanent) 



* Label sets submitted in a job stream 
without a // OPTION PARSTD,STDLABEL 
are written to the temporary area for the 
partition being used. 



Track allocations of the Label Information Cylinder for a 1, 2, 3, 4, and 5 partition system. 
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LSERV 



Job Control Statements or Operator Initiation Commands 

/" 




//TLBL 



Label 

Information 

Cylinder 




") 

_> 



r^ 






//TLBL 












"\ 


//VOL 




//TPLAB 




>. 






r ^ 


r 






^ 




Reserved 
Byte 


Filename 


Auxiliary 
Byte 


File 
ID 


File 

Serial 

Number 


Volume 

Sequence 

Number 


File 

Sequence 

Number 


Generation 
Number 


Version 
Number 


Creation 
Date 


Expiration 
Date 


File 

Security 

Number 


Block 
Count 


System 
Code 


Flag 
Bytes 


1 


7 


1 


17 


6 


4 


4 


4 


2 


6 


6 


1 


6 


13 


2 


C 


) > 


k 


1 


8 


9 


26 


32 


36 


40 


44 


46 


52 


58 


59 


65 


78 






- Di; 


placement in virtual storage 











Format and contents of the label information cylinder for tape labels 

(Shaded areas are not processed by DOS/VS Logical IOCS) 
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o 



1 


2 


3 


4 


5 


6 


7 


8 


9 


10 


11 


12 


131415 


16 


17 


18 




19 


Field 


\- 
z 
uu 

h- 

Xi- 

LLI O 

co. 2 

_JTS 
CLE 


Filename 


u 

1 

< 

to 

< 

Q 


File ID 


Q 

o 
u. 


File 

Serial 

Number 


6 

z 

& 

CD 
CO 

CD 

E 


CD 
+■" 
CD 

Q 

c 
g 

CO 

6 


CD 
+-» 
CO 

Q 

c 
o 

CO 

'q. 

X 

UJ 


"D 

| 

CD 
en 

CD 


CD 

8 

C 
CD 

a 
O 


System 
Code 


Volume 

Serial 

Number 


CD 
Q. 

> 

h- 

*-> 

C 
CD 

UJ 


O* 

z 
or 

CD 
CO 

+-> 

c 

CD 
+■» 
X 
UJ 


Extent 
Lower 
Limit 


Extent 
Upper 
Limit 


o 
■a </> 

CO T3 

8< 
35 


<3 

CD 

CN 
CO 
CN 


CD 

a 
a 

D 

CN 
CO 
CN 


Another 
Extent if 
DAM, 
ISAM or 
VSAM 


1 


7 


1 


44 


1 


6 


2 


3 


3 


2 


1 


13 


6 


1 


1 


4 


4 


2 


1 


1 


Bytes 


o 


r ~ 


00 


O) 


CO 


<* 
in 


8 


CM 

CO 


lO 

CO 


8 


o 


r*- 


00 


o 

05 


en 


CN 


CO 

en 


o 
o 


CN 
O 


CO 

o 


Displacement 



LSERV 




Field 



Name 



1. DLBL-EXTENT 



Description 

SAM 

Bit 0: 1 = Next extent on a new pack. 

Bit 1 : 1 = Last extent. 

Bit 2: 1 = Bypass extent. 

Bit 3: 1 = New volume on same unit. 

Bit 4: 1 = Extent limits omitted. 

Bit 5: 1 = Extent converted to DASD 

Bit 6: 1 = No EXTENT /XTENT card. 
Bit 7: 1 = Unused. 
DAM, ISAM, or VSAM 
Number of extents. 



Field 



Name 



12. System Code 



Description 

Initialized to contain one character 
string IBMDOSVS. This field is not 
processed by DOS/VS. 



13. Volume Serial No. Volume serial number for extent. 



14. Extent Type 



o 



Filename 
DAM/ISAM Switch 



File ID 



5. Format ID 

6. File Serial No. 

7. Volume Seq. No. 

8. Creation Date 

9. Expiration Date 

1 0. Reserved 

1 1 . Open Code 



Bits 0-3: Unused. 

Bit 4: 1 = Extent limits omitted. 

Bit 5: 1 = Extent converted to DASD 

address. 
Bits 6& 7: Unused. 

File identifier including generation 
and version numbers. If field is 
missing on DLBL card. Filename 
padded with blanks is inserted. 
This field is not used when a 
VSAM data space or Unique file 
is defined. Also, filename is not 
substituted for file-l-D with 
VSAM 

Numeric 1 is inserted. 

Volume serial number from first 
extent. 

Always initialized to X'0001'. 

Initialized with 3 bytes of X'00'. 

If date is in the form YYDDD, it is 
converted to YDD. If date is in re- 
tention period form, 1 to 4 characters, 
the field is padded with binary zeros. 

The retention period, if specified is 
converted to a 2-byte number and 
inserted in this field. 

DLBL type: 

S = SAM 

D= DAM 

A= VSAM 

C or E = ISAM System where: 

C = Load create function 

E = Load extend function 



15. Extent Seq. No. 



16. Extent Lower 
& and Upper 

17. Limits 



18. 



Logical (Symbolic) 
Unit Address 



19. 



2321 Lower Cell 
2321 Upper Cell 



Same codes as in Format-1 label: 
X'00' = Next three fields do not 

indicate any extent. 
X'01' = Prime data area ISAM, data 
area (SAM, DAM) or data 
space (VSAM), (that is the 
extent containing the user's 
data records). 

X'02' = Overflow area of an ISAM 

file. 
X'04' = Cylinder index or master 

index of an ISAM file. 
X'40' = User label track area. 
X'8n' = Shared cylinder indicator, 

where n = 1 ,2, or 4. 

Number of extent as determined by 
the extent card sequence. 

Before the OPEN, DLBL/EXTENT 
information is in the relative track 
form of HHNNT followed by three 
bytes of binary zeros. 
HH = Relative (to 0) start address in 

tracks. 
NN = Number of tracks. 
T = or upper track number for 

split cylinder in SAM files. 
Following an OPEN on DLBL/ 
EXTENT cards, or whenever DLAB/ 
XTENT cards are used, the extent 
lower and upper limits are each in the 
CCHH format. 

This 2-byte field identifies the logical 
unit with the same code as that used 
in a CCB. The first byte identifies the 
unit class: 

X'00' = System Logical Unit 
X'01' = programmer Logical Unit 
The second byte identifies the logical 
unit within its class. 

Thus X'0003' denotes SYSLST and 
X'01 03' denotes SYS003. 

2321 extent lower and upper cell 
limit. This 2-byte field contains zeros 
for disk devices. 



o 



NOTE: For SAM files, a complete 104-byte block is repeated for each new EXTENT. 

For DAM, VSAM, and ISAM files, only fields 1 3 through 1 8 are repeated for each EXTENT. 

Format and contents of the label information cylinder for DASD and DISKETTE labels. 
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LSERV 




c 






An example of some of the output to a line printer after executing the LSERV program, part 1 
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Library Display Programs and Utilities 

LSERV 



o 



















1 EXTENT INFORMATION 

1 EXTENT SEQUENCE NUMBER 

1 • EXTENT TYPE 

1 EXTENT LIMITS OMITTED 

1 SYMBOLIC UNIT 

1 • VOLUME SERIAL NUMBER 










00 

1 (PRIME DATAI 

SYSRDR CCB FORMAT 0000 
OMITTED 






1 Ft USER LABELS (TEMPORARY PER PARTITION) TRACK 


8 










| • NONE 
















1 • Fl PARTITION STANDARD LABELS (PERMANENT) TRACK 


9 










| m IJSYSIN 

1 • FILE IDENTIFIER 

1 FILE SERIAL NUMBER 

1 _ VOLUME SEQUENCE NUMBER 

1 • CREATION DATE 

1 RETENTION PERIOD (DAYSI 

1 _ FILE TYPE 










SYSRDR10 

OMITTED 

01 

OMITTED 

0007 

SEQUENTIAL 






1 EXTENT INFORMATION 

1 ^ EXTENT SEQUENCE NUMBER 

1 • EXTENT TYPE 

1 EXTENT LIMITS OMITTED 

1 _ SYMBOLIC UNIT 

1 • VOLUME SERIAL NUMBER 










00 

1 (PRIME DATA) 

SYSRDR CCB FORMAT 0000 
OMITTED 






1 STANDARD LABELS (ALL PARTITIONS-PERMANENT) 


TRACKS 


10-19 FOR 2314,10-18 FOR 3330, OR 10-11 FOR 33*0 






1 • IJSYSRS 

1 FILE IDENTIFIER 

1 FILE SERIAL NUMBER 

1 • VOLUME SEQUENCE NUMBER 

1 CREATION DATE 

1 - EXPIRATION DATE 

1 • FILE TYPE 










DOS. SYSRES.FILE 

111111 

01 

OMITTED 

99/365 

SEQUENTIAL 






1 _ EXTENT INFORMATION 

1 • EXTENT SEQUENCE NUMBER 

1 EXTENT TYPE 

1 ^ RELATIVE (TO ZERO) START ADDRESS 

1 • NUMBER OF TRACKS 

1 SYMBOLIC UNIT 

p VOLUME SERIAL NUMBER 

1° 


IN 


TRACKS 


01 

1 (PRIME DATA) 

0001 

3959 

SYSRES CCB FORMAT 0006 

111111 






1 _ IJSYSLN 
^^^^^^^^^^^FILEIDENTIFIER^^^^^ 










D0S.WORKF1LE.NO.0 — 


(&3VIKr)^^A 










DOS 


LABEL CYLINDER DISPLAY 






STAND 
_ FILE IDENTIFIER 

• FILE SERIAL NUMBER 
VOLUME SEQUENCE NUMBER 

_ CREATION DATE 

• EXPIRATION DATE 
FILE TYPE 










COMPARE-FILE FOR TESTCASE0UTPU1 

TESTV1 

01 

OMITTED 

69/001 

DIRECT ACCESS 






• EXTENT INFORMATION 

EXTENT SEQUENCE NUMBER 
_ EXTENT TYPE 

• RELATIVE (TO ZERO! START 
NUMBER OF TRACKS 

_ SYMBOLIC UNIT 

• VOLUME SERIAL NUMBER 


ADDRESS 


IN TRACKS 


00 

1 (PRIME DATA) 

0006 

387* 

SYS005 CCB FORMAT 0105 

TESTV1 






• HORKAR 

FILE IDENTIFIER 
_ FILE SERIAL NUMBER 

• VOLUME SEQUENCE NUMBER 
CREATION DATE 
EXPIRATION DATE 

• FILE TYPE 










WORK FILE FOR SLIB 

TESTV1 

01 

OMITTED 

69/001 

DIRECT ACCESS 






_ EXTENT INFORMATION 

• EXTENT SEQUENCE NUMBER 
EXTENT TYPE 

^ RELATIVF (TO ZEROI START 

• NUMBER OF TRACKS 
SYMBOLIC UNIT 

_ VOLUME SERIAL NUMBER 


AODRESS 


IN TRACKS 


00 

1 (PRIME DATA) 

3880 

0100 

SYS010 CCB FORMAT 010A 

TESTV1 






m ENO OF LABEL CYLINDER 01 SPLAY 












(V«33a*r) 


















An example of some of the output to a line printer after executing the LSERV program, part 2. 
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Library Display Programs and Utilities 
LSERV 

// DLBL filename, 'file ID', date, codes, data security 

//■ EXTENT symbolic unit, serial number, type, sequence number, relative track, number of tracks, split cylinder track, B bins 



// DLBL IJSYSRS,'DOS.RECORDER.FILE',99/365,SD 
// EXTENT SYSRES, 11111 1 .1 ,1 ,3960,20,, 




n 



JOB CONTROL statements, 

for details see DOS/VS System Control Statements 



May also be printed as 
RETENTION PERIOD (DAYS) 
Depends on the manner used to 
specify date in the D LBL 
statement. 



DOS LABEL CYLINDER DISPLAY 



FILE SERIAL NUMBER \ 


111111 




VOLUME SEQUENCE NUMBER \ 


01 




CREATION DATE \ 


OMITTED 




EXPIRATION DATE \ 


99/365 




FILE TYPE \ 


SEQUENTIAL 




EXTENT INFORMATION \ 






EXTENT SEQUENCE NUMBER \ 


01 




EXTENT TYPE \ 


1 (PRIME DATA) 




RELATIVE (TO ZEROI START ADDRESS IN TRACKS 


3880 




NUMBER OF TRACKS / 


0060 




SYMBOLIC UNIT / 


SYS004 CCB FORMAT 


0104 


VOLUME SERIAL NUMBER / 


111111 




IJSYSRC / \ 






FILE IDENTIFIER / \ 


f00S. RECORDER. FILE 




FILE SERIAL NUMBER / \ 


111111 




VOLUME SEQUENCE NUMBER 1 \ 


01 




("CREATION OATE 

l EXPIRATION DATE \ 


OMITTED 




99/365 




FILE TYPE \ 


SEQUENTIAL 




EXTENT INFORMATION \ 






EXTENT SEQUENCE NUMBER \ 


roi 




EXTENT TYPE \ 


1 (PRIME DATA) 




EXTENT LOWER LIMIT \ 


CYLINDER 198 
HEAD 00 




EXTENT UPPER LIMIT < 


CYLINDER 198 
HEAD 19 




SYMBOLIC UNIT 


SYSREC CCB FORMAT 


OOOA 


VOLUME SERIAL NUMBER 


Jlllll 




OIRECT 






FILE IDENTIFIER 


NAME-LIST 




FILE SERIAL NUMBER 


HELP01 




VOLUME SEQUENCE NUMBER 


01 




CREATION OATE 


OMITTED 




EXPIRATION DATE 


69/001 




FILE TYPE 


DIRECT ACCESS 




EXTENT INFORMATION 






EXTENT SEQUENCE NUMBER 


00 




EXTENT TYPE 


1 (PRIME DATA) 




RELATIVE (TO ZEROI START ADDRESS IN TRACKS 


0020 




NUMBER OF TRACKS 


0003 




SYMBOLIC UNIT 


SYS005 CCB FORMAT 


0105 


VOLUME SERIAL NUMBER 


HELPil 








(fxWAX 



o 



Relationship between DLBL/EXTENT card data and the information printed by the LSERV program. 
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Under certain circumstances knowing the contents of libraries can be helpful 
during program debugging. The library display programs DSERV, CSERV, PSERV, 
SSERV, and RSERV enable you to print an image of: 

• Any library directory 

• Any library 

• Any program in any library 

• Any phase in any library. 

When using DSERV, a System Status Report is always printed before the specified 
directory. A private status report is also printed when private libraries are used 
with the system. 

An example of a system status report is shown in two examples at the end of the 
section describing the Linkage Editor Map (E-4 of this manual). 



Library Display Programs and Utilities 

LIBRARY DISPLAY 



,y 



When and how to use 

Control statements required to execute the library display programs are shown in 
the next two tables. 

The following list gives some examples of when to use the various library display 
programs: 

1. The operator action given under the appropriate message in DOS '/VS Messages 
indicate when to execute DSERV. 

For example, under the message: 
1C33A PROGRAM NOT FOUND 

When error message instructions include a library display, enter cards that 
correspond to the library and type of display. Be sure to substitute the actual 
program module, book, sublibrary or phase name for the words phase 1 , module 1 , 
book 1 , sub lib 1 , or prog 1 . 

Note: If you assign a private library and display that type of library, only the private 
library will be displayed. To obtain a display of the system library, the private 
library must be unassigned. 

Additional information on the display program is found in DOS/VS System 
Con tro I Sta temen ts. 

Further recommendations as to when to use the library display programs are given 
after the two tables following. 
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Library Display Programs and Utilities 



LIBRARY 
DISPLAY 



Control cards required to execute the Library display programs 



Unit 


Element 


Control Statements Required 


Core Image 
Library 


Phase 


// JOB jobname 
//EXECCSERV 

DSPLY phasel [,phase2,...] 

/• 
/& 


Program 


// JOB jobname 
//EXECCSERV 

DSPLY prog1.ALL[,prog2.ALL,...] 

/* 

/& 


Library 


// JOB jobname 
//EXECCSERV 
DSPLY ALL 

/* 
/& 


Directory 


Unsorted 
// JOB jobname 
// EXEC DSERV 

DSPLY CD 

/* 
/& 


Sorted 
// JOB jobname 
//'EXECDSERV 

DSPLYS CD 

/* 
/& 


Relocatable 
Library 


Module 


// JOB jobname 
// EXEC RSERV 

DSPLY modulel [,module2,...] 

/• 

/& 


Program 


// JOB jobname 
// EXEC RSERV 

DSPLY progl .ALL[,prog2.ALL,...] 

/* 

/& 


Library 


// JOB jobname 
// EXEC RSERV 
DSPLY ALL 

/* 

/& 


Directory 


Unsorted 
// JOB jobname 
// EXEC DSERV 

DSPLY RD 
/* 
/& 


Sorted 
// JOB jobname 
// EXEC DSERV 

DSPLYS RD 

/* 

/& | 



Table C-2 Library Display Control Cards (Part 1 or 2) 

Note: To execute DSER V, SYSIN must be assigned to a card reader, a tape unit, or a disk drive. 
SYSLOG must be assigned to a 1052, 3210 or 3215 console printer, or for the Model 125 
it must be assigned to the CRT. 
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Library Display Programs and Utilities 

LIBRARY 
DISPLAY 



Unit 


Element 


Control Statements Required 


Source 

Statement 

Library 


Book 


// JOB jobname 
// EXECSSERV 

DSPLY sublib.bookl [,sublib.book2,...] 

/* 

/& 


Sub- 
library 


// JOB jobname 
// EXECSSERV 

DSPLY sublibl .ALL[,sublib2.ALL,...] 

/* 
/& 


Library 


// JOB jobname 
// EXECSSERV 
DSPLY ALL 

/* 
/& 


Directory 


Unsorted 
// JOB jobname 
// EXECDSERV 
DSPLY SD 

/* 
/& 


Sorted 
//JOB name 
// EXECDSERV 
DSPLYSSD 

/* 
/& 


Procedure Library 


Directory 


Unsorted 
// JOB name 
// EXEC DSERV 

DSPLY PD 
/* 
/& 


Sorted 
//JOB name 

// EXEC DSERV 

DSPLYSPD 

/* 
/& 


Library 


// JOB jobname 
// EXECPSERV 
DSPLY ALL 

/* 
/& 


Procedure 


// JOB jobname 
//EXECPSERV 

DSPLY procedural [,procedure2,..] 


Directories 


All 


Sorted 
//JOB name 
// EXEC DSERV 
DSPLY ALL 

/* 
/& 


Sorted 
// JOB jobname 
// EXEC DSERV 
DSPLYS ALL 
/* 
/& 


Systems 
Directory 




// JOB jobname 
// EXEC DSERV 

DSPLY SD 
/* 
/& 




Table C-2 Library Display Control Cards (Part 2 of 2) 



^j^iiF 
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Library Display Programs and Utilities 

LI B R AR Y D ISP LAY 2. Execute DSERV when you require details about the core image library. 



■ 
































■ 






•SYSTEM CORE IMAGE DIRECT 
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□ RY 






















PHASE 


DISK 




TXT 


BTS LST 


RID 


RLD 


LOAD 


ENTRY 


PART ENTRY 


SVA 


IN 










NAME 


ADDR 




RCDS 


TXT RCD 


RCDS 


ITEMS 


ADDR 


ADDR 


ADDR AODR 


ELIG 


SDL 












C 


H 


R 




























E6RAST13 


005 


00 


02 


001 


0582 






000000 


000000 
















EIJKSOO 


033 


06 


04 


001 


0536 






000000 


000000 
















| EIJKSIO 


033 


06 


05 


001 


0284 






000000 


000000 
















EIJKS20 


033 


06 


06 


001 


0488 






000000 


000000 
















EIJKS30 


033 


07 


01 


001 


0592 






000000 


000000 
















| EIJKS40 


033 


07 


02 


001 


0392 






0000 00 


000000 
















EIJKS50 


033 


07 


03 


001 


0360 






000000 


000000 
















EIJKS60 


033 


07 


04 


001 


0672 






000000 


000000 
















| EIJKS70 


033 


07 


05 


001 


0584 






000000 


000000 
















SIPLRT2 


005 


02 


06 


006 


0072 






000000 


000C68 
















EIPLRT3 


005 


03 


06 


003 


0248 






O0OC68 


000C68 
















| EIPLRT4 


005 


04 


03 


006 


0416 






000C68 


0O0C68 
















EIPLRT5 


005 


05 


03 


005 


0240 






000C68 


000C68 
















EJOBACCT 


005 


09 


03 


001 


0002 






000000 


000000 
















| EJOBCTLA 


000 


17 


03 


009 


0720 






000000 


001810 
















EJOBCTLB 


000 


18 


06 


004 


0340 






001810 


001810 
















EJOBCTLO 


000 


19 


04 


Oil 


05 04 






001810 


001810 
















| EJOBCTLE 


001 


01 


03 


007 


0610 






001810 


001810 
















EJOBCTLF 


001 


02 


04 


006 


0444 






001810 


001810 
















EJOBCTLG 


001 


03 


04 


006 


0148 






001810 


001810 
















| EJOBCTLJ 


001 


04 


04 


008 


0208 






001810 


001810 
















EJOBCTLK 


001 


05 


06 


005 


0972 






001810 


001810 
















EJOBCTLM 


001 


06 


05 


007 


0136 






000000 


000000 
















| EJQBCTLN 


001 


07 


06 


001 


0784 






001810 


001810 
















ELIBSTAT 


005 


02 


01 


004 


0984 


001 


00011 


040800 


040800 


040078 


YES 










D 


ELNKEDT 


005 


06 


02 


019 


0491 






000000 


003EC8 
















) EMAINDIR 


005 


00 


03 


CIO 


0976 


000 


00011 


040800 


040800 


040078 


YES 












ALIST 


010 


12 


05 


012 


06 2 8 


001 


00100 


040078 


040300 


040078 














ALTDC 


010 


OR 


03 


004 


0700 


000 


00053 


040078 


04031A 


040078 






ex 15*7 




1 
































■ 



PHASE NAME 


The names of programs (phases) 


DISK ADDR 


The disk address of the phase on the core image library (Disk address of first text, TXT, record) 


TST RCDS 


The number of records belonging to the phase (Number of TXT records) 


BTS LST 
TXT RCD 


The number of TXT bytes in the last TXT record 


RLD RCDS 
(see note 1 ) 


The number of additional relocation list dictionary (RLD) records, referring to the address constants in the text 
that will be modified by the relocating loader 


RLD ITEMS 
(see note 1 ) 


Total number of RLD items that show the total number of TXT modifications due to relocating load 


VER MOD 
LEV LEV 
(see note 2) 


The version and modification level of phases, modules, and books in the core image, relocatable, and source 
statement libraries respectively. 


LOAD ADDR 


The load address of the phase at the time it is link-edited to core image library (Link-edit time) 


ENTRY ADDR 


Entry address of the phase at link-edit time 


PART ADDR 
(see note 1 ) 


Start address at link-edit time of the partition to which the phase is link-edited 


ENTRY ADDR 


The entry address in the SVA of the phase contained in the SVA. (These phases can be loaded into the SVA after 
IPL or by cataloging them into the SVA during system operation.) 


SVA ELIG 


A YES in this column indicates that it is permissible to load the phase in the SVA either after IPL time or during 
system operation using the linkage editor. 

(It indicates that the phase is reentreable and relocatable which it must be to enable its use by the system when it 
resides in the SVA.) 


IN SDL 


A YES in this column indicates that the name of the phase is in the SDL. 

Note: A phase name can be present in the SDL but need not necessarily be present in the system core image 

library. 



J 



Notes 1. Entries are printed in these columns only when a relocatable phase is found in the library. 

2. Version and modification levels are always listed for modules and books displayed, but are listed for phases 
only when displaying a specific phase. This information is required under some conditions of system mal- 
functions that may be caused by the use of programs at different levels of modification. 

Most IBM-supplied programs have a 2-byte VM (version and modification level) number. The number may be 
in decimal or hexadecimal form in a storage dump, depending on the input format. It is in decimal form in a 
DSERV printout of the source statement or relocatable library. For example, version 5 modification level 
appears at 2800 or F2F8 in a storage dump and a 5.0 in a DSER V printout. The VMs for phases and transients 
are contained within the phase or transient. 

Your IBM CE/FE can also check your library by using DSERV to examine it for the applicability of an IBM- 
supplied program temporary fix (PTF). 

The modification level of your library is also required if an authorized program analysis report (APA R) must 
be submitted to IBM for analysis of a particularly difficult programming error. 
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Hardware Error Recording and Recovery 

TES or TES with Operands E R E P 

The TES options provide for the editing and printing of the tape error records on 
SYSREC and the summarizing of tape data found on either SYSREC or the history 
file. 

To enable this option to be used a work or scratch tape must be mounted on a tape 
unit assigned to SYS008. This option can also select tape error data from the 
SYSREC file and create a TES history tape with the same format as the previously 
supported ESTV tape file. All records on the tape appear in chronological order. If 
an unrecoverable I/O error occurs while reading a record from the SYSREC file, 
the record is ignored and processing continues with the next sequential record. If 
the data fills the complete tape, the message 

3E15ATAPE FULL, MOUNT NEW TAPE 

is printed on SYSLOG. The operator must mount a new tape and press END, or he 
may respond CANCEL END; the latter response causes tape updating to be 
discontinued, but TES records are still printed. 

The tape must be mounted on SYS009, which must be assigned to a tape drive 
before EREP is executed. The tape contains standard labels that are checked 
before the history /RDE tape is written. If the wrong tape is mounted, the message 

3E31A WRONG TAPE, MOUNT CORRECT TAPE 

is printed on SYSLOG. Mount the correct tape and press END to continue processing, 
or respond CANCEL END to cancel the TES option. The history/RDE tape and 
TES history tape should be created or updated during the same EREP run. If the 
HIST option is specified without the TES option, the SYSREC File is cleared after 
HIST has been executed, and the TES data is lost. If you wish to maintain both 
these history tapes and the TES and HIST options are not specified together in 
one EREP run, the data on the TES history file may be redundant or lost. 

TES,NEW: This causes EREP to create a TES history file on the tape unit 

assigned to SYS007. The tape file contains tape error data from the SYSREC file. 

The tape error data on the tape has the same record format as the previously 

supported ESTV tape file. Use ESTVUT utility program to print this tape file. 

TES: EREP updates the TES history tape on SYS007. 

TES,NOTAPE,PRINT: Causes the tape data on SYSREC to be edited and printed 

into SYSLST. Data is printed in the detail tape unit format. 

TES,PRINT,NEW: A new TES history tape is created on SYS007, after which the 

tape error data on SYSREC is edited and printed on SYSLST. The data is printed 

in the detail tape unit format. 

TES.PRINT: The TES history tape, which is mounted on SYS007, is updated. 

The tape error data on SYSREC is then edited and printed on SYSLST in the 

detail tape unit format. 

TES,NOTAPE,SUM: The tape error data on SYSREC is summarized by tape drive. 

TES,NOTAPE / PRINT f SUM: The tape error data on SYSREC is edited and printed 

on SYSLST in the detail tape unit format. Then the tape error data on SYSREC is 

summarized by channel and unit and printed on SYSLST. 

TES,SUM,VOL: The TES history tape on SYS007 is updated. Afterwards the 

tape error data found on SYSREC is summarized by volume serial number. 

TES,PRINT,VOL: The TES history tape mounted on SYS007 is updated. The 

tape error data on SYSREC is edited and printed on SYSLST in the detail volume 

serial number format. SYS008 is used as a work tape and the detail records are 

printed in sequence by volume serial number. 

Four examples of processing tape error statistics using EREP are given in 
I Appendix J. 
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Hardware Error Recording and Recovery 

EREP EREP History Tapes 



There are three types of EREP history tapes: the History tape, the RDE tape, and \^/ 

the TES history tape. The History and RDE tapes are created and updated from the 

SYSREC file and contain all the record types found on the SYSREC file. The TES 

history tape is also created from the SYSREC file, but contains only tape error 

records. If your installation has the History/RDE tapes and a TES history tape, you 

should create (or update) all the history tapes in the same run. If this procedure is 

not followed, the TES history tape may have redundant or missing data. 

Retain the History and TES history tapes for those persons who work on problem 
determination. The History tape can be used as input for certain online test 
programs of OLTEP. (See the OLTEP manual.) The TES history tape can be printed 
with the ESTVUT utility program. Retain the RDE tape; it will be used by IBM. 

History/RDE Tape 

The History/RDE tape is created and updated using the EREP history option. This 
tape contains RDE data only if ERRLOG=RDE is specified at system generation. A 
magnetic tape unit assigned to SYS007 must be used for this function. EREPNEW 
must be the filename that is used when a tape is created, and EREPUP when a tape 
is updated (both TLBL cards must be included for UPNEW). When the tape becomes 
full or when a second tape must be mounted, the operator is notified via SYSLOG. 

Note: If EREP is link-edited as a self-re locating program, a LBL TYP card is 
needed when EREP builds a history /RDE tape. 

TES History Tape 

The TES history tape is created and updated using the EREP TES options. A 
magnetic tape unit assigned to SYS007 must be used for this function. The filename 
of the tape file must be TAPEIN when the file is created and the file is updated. 

Creating the History Tapes 

You can create a history tape only if DOS/VS has recorded errors on SYSREC. 
The EREP program allows you to create or update the three types of history tapes. 

You can create the History/RDE tape by specifying OPTION HIST, NEW, and 
update it by specifying OPTION HIST. 

If a System/370 RDE tape is to be processed, the message 3E16A is printed on 
SYSLOG after the History tape is written. This message instructs you to replace 
the History tape reel with the RDE tape' reel and then respond to the message. A 
response of END will cause the RDE tape to be processed and response of CANCEL 
END will cancel only the HIST option. Any other response will cause the system 
to reissue message 3E1 6A. 

In addition, you can create a TES history tape, which contains only tape error 
records. If you want to maintain a TES history tape, create (or update) it in the 
same EREP run in which you create (or update) the History/RDE tape. You can 
create the TES history tape by specifying OPTION TES,TAPE,NEW, and update 
it by specifying OPTION TES, TAPE. 



w 



^^J^ 
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Updating will continife with the next update control card for all errors except when: 

• The COL statement has invalid operands. 

• COL statement is not the first update control statement. 

• The macro is completely de-edited without all update control statements 
being completely processed. 

• An RST statement has an invalid operand. 

Appendix D shows two ESERVjob stream examples. 



Library Display Programs and Utilities 

ESERV 




macro source 
deck 




SYSIPT 



SYSPCH 




ESERV 







SYS001/2 

This illustrates the input to and output from the ESERV 



SYSLST 



When to use 



• Use ESERV to punch up a new card deck. 

• ESERV can be used to list the source code of an edited macro. 

• If an IBM program tempory fix (PTF) is to be installed in your library, use 
ESERV to de-edit and update the macro. An example of installing a PTF 
using ESERV is given in appendix D. 

Note: Before installing a PTF use either ESER V or SSER V to display the macro in 
order to check if the PTF is applicable. 
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LVTOC 



The LVTOC program enables you to print out VTOC (volume table of contents) of 
a DASD disc pack. 

From the printout (the VTOC display), you can see the names of files, contained 
on any disc pack, their extents, and addresses. A VTOC display, therefore, enables 
you to keep track of data sets and files on all your packs. 

Additional information on the VTOC display program can be obtained from 
DOS/VS System Control Statements 



Information in the VTOC 

All standard file labels are grouped together and stored in a specific area on a disk 
pack or data cell. This group of labels essentially a directory of all data records on 
the volume because each file label contains file limits. Therefore, this group of 
labels is called the volume table of contents, or VTOC. Because the VTOC itself 
is a file of records containing one or more standard label records for each logical 
file, it is defined as such with its own file lable. 



Last 

Volume 

Label 



VTOC 
File Label 
(Format 4) 



VTOC 
File Label 
(Format 5) 
(Used by 
OS/VS 
only) 


File 
Labels 


Filename = 
XXXXXX 
Format 1 
Label 


Additional 
File Labels 


Pointer to 
last active 


i 




Pointer to i{ 








file label 


file extents, 
if necessary. 



Filename = 
XXXXXX 
Additional 
Extents 
(Format 3) 



Function of the VTOC 

Before a DASD file can be processed by logical IOCS, the file must be opened to 
permit transfer of data. The open routines check the DASD labels identifying the 
file. This is accomplished by comparing the information from the actual file 
labels in the VTOC with the label information in the SYSRES label information 
cylinder. (See LSERV in this Section for a description of the label cylinder.) 

The illustration opposite is a overview of how DOS/VS uses the VTOC. 






DASD Label Formats 

The VTOC contains all format labels. Each format label points to an area of DASD 
storage on the volume and indicates what the area is currently being used for. A 
format 1 label describes one to three physical areas (extents) on the volume. It is 
the first format label used to describe each file. 

A format 2 label describes a file as being indexed sequential. If a format 2 label is 
used, there is always a format 1 label describing the same file. 

A format 3 label describes from one to thirteen extents on the volume. It is used 
when a file is made up of four to sixteen extents (the format 3 label is always 
associated with a format 1 label). 

A format 4 label describes the VTOC. 

A format 5 label is not used by DOS/VS. 

The following illustrations show the layout of format labels 1 to 4, with examples 
of printouts from the VTOC display program. 

A detailed description of these label formats is given in DOS/VS Data Management 
Guide. 
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Library Display Programs and Utilities 

LVTOC 



Filename for DTF matches 
filename in DLBL statement 



job //DLBL Filename, File ID , etc. 

control // EXTENT Symbolic name, Volume number 



C 



Standard Volume Label: 
Cylinder 0, Track 0, Record 3 
(Written during disk 
initialization) 



The VTOG 
Format 4 label 




Label information 
cylinder 




SYSRES 



During the OPEN routine: 

1. Read SYSRES label information. 

2. Locate the VTOC via the 
standard volume label. 
For DASD input files: 
Compare format 1 label information 
(or format 2 for IS files) to information 
in the DLBL card. 
Check each extent definition in 
format 1 and 3 labels against the 
limit fields in the EXTENT card(s). 
For DASD output files: 
Create the format 1 label from 
information in the DLBL/EXTENT 
cards. (Format 1 is always present 
followed by format 2 for IS files) . 
If extra extents are to be described 
create format 3 labels following 
the format 1 or 2, or another format 3. 

During the CLOSE routine: 
1 . Read, update, and rewrite format 1 
and 2 labels for IS files. 



An overview showing how the DOS/VS uses the VTOC. (Not applicable to VSAM 
files) Details are found in DOS LIOCS Vol 1 



Serviceability Aids. 2.1 19 



Library Display Programs and Utilities 

LVTOC Executing the VTOC display program 



The control cards necessary to execute VTOC in a virtual partition are: 

// JOBjobname 

// ASSGN SYS004,X'cuu' (input) 
// ASSGN SYS005,X'cuu' (output) 
// EXEC LVTOC 

/& 

The operator commands necessary are: 

1. Press REQUEST on the console printer keyboard 

2. PAUSE (BG F4, F3, F2, Fl), EOJ 

3. // ASSGN SYS004,X'cuu' (input device) 

4. // ASSGN SYS005,X'cuu' (output device) 

5. // EXEC LVTOC 

Where: 

• SYS004 is assigned to the channel and unit address (cuu) of the DASD on 
which the disk pack is mounted. 

• SYS005 is the output device, normally a printer. If the output device is not 

a printer, TLBL, DLBL, and EXTENT cards must be included to describe the 
output device. The filename for these cards is UOUT. 

The first of the two examples on the opposite page is a VTOC display using the 
LVTOC program. 

Two other methods of obtaining a VTOC display are as follows: 

• Instead of typing CANCEL to terminate the job, the operator can type 
CANCELV to get a VTOC dump on SYSLST, if SYSLST is a printer. Refer 
to the second example on the opposite page. 

• The operator can display the VTOC by typing DSPLYV (in response to an 
error message). This reply does not terminate the job, but reissues the same 
message issued prior to the VTOC display request. (The output can be 
directed to SYSLOG if SYSLST is not assigned.) Refer to the example at the 
end of this chapter. 

Operator actions given in DOS ; /VS Messages indicate methods to obtain a VTOC 
display for particular messages. 



When to use 

The five examples listed below illustrate when and how the VTOC display program 
can aid program debugging by providing details about your disk volumes: 

1. During disk pack initialization, the VTOC label is checked. A message is printed 
on SYSLOG if there is an unexpired file in the pack. If the contents of the pack 
are unknown or its validity is in doubt, a VTOC listing will enable you to check 
the unexpired file. You can then decide if the unexpired file is to be retained 

or replaced by different extents. 

2. Before copying a volume it is useful to keep a record of the contents of the 
volume to be copied and the volume that receives the copy. Having a record will 
reduce debugging time if an error occurs in a program that uses one or both of 
these packs. 

3. A VTOC display enables you to monitor and keep track of volume areas, thus 
allowing economical use of your packs. 

4. If the input data contained on a pack is causing program errors, a VTOC listing 
of the input volumes enables you to check for the presence (or absence) of data 
sets. 

5. If, during program execution, a system malfunction prevents workfiles from 
being properly closed by the CLOSE macro, it is probably that volumes used 



O j 



J 
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o 



during the program will cause program errors when used for future jobs. This is 
because the VTOC label would not have been updated by the CLOSE macro. It is 
useful, therefore, to obtain a VTOC listing of the volumes affected. 



Examples of the LVTOC output 



LVTOC 









V70C DISPLAY U7ILITY 








' LABEL IDEMT - 


VOL1 


VTOC LOCATION IS CYLINDER - 199 


SERIAL NUMBER - 111111 OWNER 


IDENT - 




T 0,R 1 FCRMAT 4 


LAS7 AC7IVE UNUSED ALTERNA7E 7RACK INF0RMA7I0N 
FORMAT 1 LABELS L0CA7I0N NO. OF 7RACKS 


EXTENT INFORMATION 
SEQ TYPE LOU HIGH 








473 200 




60 


PRIME 199 199 18 




7 O.R 2 FORMA7 5 


USED 


ONLY BY 0/S 360, NOT SUPPORTED BY DOS 












' 7 O.R 3 FORMA7 1 




SERIAL NUMBER - 111111 LENGTHS 
FILE ID KEY BLOCK 


RCD 


DATES 
CREA7E EXPIRE 


SYSTEM 

I DENT 


EXTENT INFORMATION 
SEQ TYPE LOW HIGH 




' PAGE DA7A SE7 




2048 


2048 


73 278 99 365 


IBMDOSVS 


180 186 19 




' 7 O.R 4 FORHA7 1 




SERIAL NUMBER - 111111 LENGTHS 
FILE ID KEY BLOCK 


RCD 


DATES 
CREATE EXPIRE 


SYSTEM 
IDENT 


EXTENT INFORMATION 
SEQ TYPE LOW HIGH 




DOS. RECORDER. FILE 










73 278 99 365 


IBMDOSVS 


1 PRIME 198 198 19 


□ 


' 7 O.R 5 FORMA7 1 




SERIAL NUMBER - 111111 
FILE ID 


LENGTHS 
KEY BLOCK 


RCD 



DATES 
CREATE EXPIRE 

73 278 73 249 

OATES 
CREATE EXPIRE 

73 278 99 365 

'SAM f&& 


SYSTEM 
IDENT 

IBMDOSVS 

SYSTEM 

IDENT 

IBMDOSVS 


EXTENT INFORMATION 
SEQ TYPE LOW HIGH 

1 PRIME^21 14 41 13 «. 

EXTENT INFORMATION 
SEQ TYPE LOW HIGH 

1 PRIME 1 20 19 

(£x 37/Cr) 


' JBUG. GENERATOR. HORKFILE.K 
7 O.R 8 F0RMA7 1 
DOS.WORKFILE.NO.O 
END OF V70C LIS7ING 


TOMS ^/^ -***&** 


SERIAL NUMBER - 111111 
FILE ID 


LENGTHS 
KEY BLOCK 




RCD 



( 4 


fi&Kt/£ 


£ i 






















An example of the output on a line printer after executing the LVTOC program 



%mr 




An example of the output on a line printer after issuing the CANCELV command 
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LVTOC 



BG 

|BG ASSGN SYSPCHrX'131' 
;BG 4444A OVERLAP ON UNEXPRD FILE 
i BUG . GENERATOR r WORKF I LE . K . TOMS 
! BG dsp I yv ^ 



|BG 4V95A SYSLOG OR SYSLST 

i BG <; y <; I o g ^- 

'BG 



I JS YGPH S YSPCH= 1 3 1. 1 1 1 1 1 1. 



DSPLyV 4frr*/»ia*t</ 



oufeu/- fc sys<co<? 



BG VOLUME SERIAL NO,. IS 11.11.11 



iBG PAGE DATA SET 

!BG 2100 OOB40000-OOBA0013 



BG DOS. RECORDER. FILE 
IBG 0101 O0C6O00O-0OC60O13 

I BG (iBUG . G ENERATOR > UQRKF 1 LE. K ■ TOMS » 
BG \0 1 1^)0 1 5000E '-jOOlWXXMf 



10/04/13 
1 1 1 1 1 1 1 0001 0D01i::5--63016D 

1111111 0001 0D0115-63016D 



OD():i 



-4900F9 




cy ho cy ho 

.WORKFILE.NO.O 
1 0001.0000-00140013 



v 1111111 0001 0D01 15-630161 



Vo-cutte, 



,BG VTOC DISPLAY COMPLETED 



i 



Ex3*KT 



An example of the output on a 3215 console printer keyboard after issuing the 
DSPLYV command. 




An example of the output on a line printer after issuing the DSPLYV command. 
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Library Display Programs and Utilities 

The S YSVIS DUMP program copies the contents of the page data set (PDS) S YS V I S D U M P 

contained on the system logical unit SYSVIS on to magnetic tape or disk pack. 
A printout on SYSLST can then be obtained for use during offline program 
debugging. The utility also enables you to dump the contents of the PDS directly 
to SYSLST, which can be assigned to a tape unit,, a disk drive, or a line printer. 

The SYSVIS dump may also be referred to as the Page Data set dump. 

Restrictions 

This utility program can be used only to copy or dump the contents of the PDS 
contained on SYSVIS. Any other use is automatically rejected by the system. 
Because paging must not occur during execution of this utility when dumping 
from SYSVIS do not start or run any other jobs either before or during its execution. 

Description and operation 

This utility program is initiated by normal JCL through SYSLOG or SYSIPT by 
the execute statement // EXEC PDSDM. Parameters entered either through 
SYSLOG or SYSIPT enable you to select areas of SYSVIS, thus avoiding the 
need to dump all of the virtual address area contained on SYSVIS. 

The following areas can be selected: 

• The entire PDS, that is, all the virtual address area 

• Any specified virtual partition 

• One or more pages contained within any virtual partition. 

Multiple parameters can be specified but they must be confined to one card 
image. Multiple cards are possible. 

For example: 

BG, (089ABC,08ABCD), F4 punched in a card or entered through SYSLOG 
causes a dump of the whole of the background and foreground 4 virtual 
partitions, and the pages on the PDS that contain any addresses between the 
address limits 089ABC and 08ABCD. 

(Addresses are specified by six hexadecimal digits.) 

The dump output is directed to SYSLST or SYS001 , depending on the parameters 
specified. For example, a response to SYSLST to the message 0V23D TO= causes 
the dump to be directed to the device assigned as SYSLST. 

If SYS001 is used as the input or output device, tape or disk label information 
must be supplied in the job stream. 

If the dump is from SYSVIS, it is accessed by assigning SYS000 to it. The 
necessary disk label information must then also be supplied in the job stream. 

Job stream examples are shown on the following pages. 

The format of the dump output is similar to the output obtained from the 
stand-alone dump, that is, each 2K of virtual storage contained on the PDS is 
separated and given a block number starting with BLOCK 0000. Blocks 
containing only zeros are suppressed. An example of the stand-alone dump 
output is shown in Appendix G. 
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S YS V I S D U M P How to execute 



Because this utility consists effectively of three separate utility programs, it is 
necessary to show three sample job streams. 

Example 1 shows the job stream required to copy SYSVIS to SYS001, where 
SYS001 can be assigned to either a tape unit or a disk drive. 

Example 2 shows the job stream required to dump SYS001 to the device assigned 
toSYSLST. 

Example 3 shows the job stream required dump SYSVIS directly to the device 
assigned to SYSLST. 

To ensure that the contents of the PDS and the allocations of the virtual address 
area are the same as they were just prior to the execution of the stand-alone dump 
the following instructions must be adhered to: 

1 . Re-IPL using identical parameters for the DPD command as specified in the 
previous system IPL. However you must specify N to the parameter TYPE=. 

2. Check for any previous ALLOC commands. You must specify identical virtual 
partition allocations as existed just before the stand-alone dump was executed. 

Example 1: Copying SYSVIS to SYS001 on tape or disk. 
(SYS001 must be a DASD device) 

// JOB COPYPDS where CUU is the physical address 

// ASSGN SYS000,X'cuu' of SYSVIS. 

// ASSGN SYS001 ,X'cuu' where CUU is the physical address 

of the device to be used as 
temporary storage for the PDS. 

// DLBL PDSDISK/PAGE DATA SET 

// EXTENT SYSOOO 

// DLBL S01 DISK/BACKUP FOR PDS' [,date] 

// EXTENT SYS001,vol ID, ,relative starting address, number of tracks 



o 






If the PDS copy is to be on tape, replace the previous two statements by the 
following: 

// TLBL S01 TAPE,' BACKUP FOR PDS' 

followed by: 

// EXEC PDSDM where PDSDM is the phase name 

for the utility contained on the 
system core image library. 
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Example 2: Dumping SYS001 to SYSLST 

// JOB DUMPPDS 

// ASSGNSYS001,X'cuu' 

// DLBL PDSDISK/BACKUP FOR PDS' 
// EXTENT, SYS001 



Library Display Programs and Utilities 

SYSVIS DUMP 



where CUU is the physical 
address of the device containing 
the copied PDS. 



If the copied PDS is on tape, replace the previous two statements by the following: 

// TLBL PDSTAPE/BACKUP FOR PDS' 
followed by: 

// EXEC PDSDM 

If parameters are to be read through SYSIPT respond to message 0V20D with 
IPT, press the END key and use the following statement: 

TO=SYSLST, T followed by the cards containing the parameters and 
/& 

Respond to message 0V20D with LOG and press END if parameters are to be 
read through SYSLOG. 

Only pressing the END key as the answer to message 0V20D causes a dump of the 
whole PDS to SYSLST. 

If LOG is entered followed by END key the following message is issued on 
SYSLOG: 

0V23D TO= 

Respond to this with: 

SYSLST ,T This selects SYS001 as input device and SYSLST as output 
device for the dump. 

This is followed by the message: 

0V21D GIVE PARAMETERS 

Pressing the END key after entering parameters causes an immediate dump of the 
areas specified followed by the message: 

0V21D GIVE PARAMETERS 

Further parameters can be entered but if no more areas of the PDS are to be 
dumped, either enter EOJ or press the END key. This terminates the job. 

Note: On Models 115 and 125 the END key is replaced by the ENTER key. 
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Library Display Programs and Utilities 

SYSVISDUMP 



Example 3: Dumping SYSVIS direct to SYSLST. 

//JOBDUMPPDS 

// ASSGN SYS000,X'cuu' where CUU is the physical address of 

SYSVIS. 
// DLBL PDSDISK/PAGE DATA SET 
// EXTENT SYS000 
// EXEC PDSDM 

If parameters are to be read through SYSIPT this must be followed by: 

TO^SYSLST followed by the cards containing the parameters and 
/& 

Respond to message 0V20D with either LOG or IPT and press the END key. 
(END key only is an invalid response.) If LOG is entered followed by END key 
the following message is printed on S YSLOG : 

0V23D TO= 

Respond to this with SYSLST. This selects SYSVIS as input device and SYSLST 

as output device for the dump. 

This is followed by the message; 

0V21D GIVE PARAMETERS 

Pressing the END key after entering parameters causes an immediate dump of the 
specified areas of SYSVIS and is followed by the message: 

0V21D GIVE PARAMETERS 

Further parameters can be entered, but if no more areas of SYSVIS are to be 
dumped either enter EOJ or press the END key to terminate the job. 

Pressing the END key before entering parameters causes the whole PDS to be 
dumped on SYSLST. 

Note: On Models 115 and 125 the END key is replaced by the ENTER key. 
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Library Display Programs and Utilities 

Error messages SYS VIS DUMP 

The list below summarizes the error messages that are printed on SYSLOG to 
inform the operator of incorrect job stream input: 

• Invalid parameters are specified. 

• SYSLST or SYS001 is incorrectly specified. 

• Start address is greater than end address. 

• Partition is not allocated. 

• Address or partition is in real storage. 

• Address is greater than end of virtual storage. 

• Partition ID is invalid or greater than number of partitions allocated. 

• Incorrect assignments for SYS000 and/or SYS001 . 

• Attempt to dump a file other than the PDS. 

Incorrect addresses and partition IDs are flagged by an asterisk* printed on the 
line below. For example: 

BGbg,0809ab,f4J48000,05f5ee,(0809ab,096000)f2, 

BG * 

BG 0V40I ADDRESS IS OUTSIDE OF VIRTUAL PARTITIONS 

Pressing the END key causes the areas that are specified correctly to be dumped 
up to the first invalid parameter. The incorrect parameters can be corrected 
through SYSLOG. If the input is through SYSLOG, further parameters can be 
specified after the message: 

0V21D GIVE PARAMETERS 

If the input is through SYSIPT, you can switch back to SYSIPT as input device 
for specification of further parameters by entering IPT to the message: 

0V21D GIVE PARAMETERS 

Terminating the dump 

This can be done in any of the three ways given below: 

• Enter EOJ on SYSLOG 

• Having a /* or a /& card at the end of the job stream when entering 
parameters through SYSIPT. 

• Pressing the END key in response to the message: 0V21D GIVE 
PARAMETERS after at least one address has been processed. 

Note: On Models 115 and 125 the END key is replaced by the ENTER key. 
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Library Display Programs and Utilities 

SYSVISDUMP 



When to execute the dump 



It is recommended to obtain a dump of SYSVIS whenever a stand-alone dump is 
executed. SYSVIS DUMP should not be executed until the stand-alone dump has 
been completed, and should be initiated during the system re-IPL. To help your 
analysis of the information contained in the SYSVIS dump it is also recommended 
to execute a formatted stand-alone dump as described in A-3 of this Section. For 
this reason, execution of this utility is included in the flowchart A-3-F "Executing 
the Stand Alone Dump". 



How to use the dump output 



During analysis of a system malfunction, such as a HARD WAIT STATE using a 
stand-alone dump output, it may be necessary to analyze the coding in a page 
belonging to a virtual partition which was not in real storage when the stand-alone 
dump was executed. 

The virtual address allocations can be obtained from the BOUNDARY BOX, and 
pages not in real storage can be found by analyzing the contents of the PAGE 
TABLE. The format and contents of the boundary box and the page table are 
described in Section 4, Chapter 12 of this manual. 

Therefore, the SYSVIS dump should be used in conjunction with the stand-alone 
dump output. It is recommended to always use a stand-alone dump generated with 
the DUMPGEN parameter FORMAT=YES. DUMPGEN is described in A-3 of 
this Section. 

It is essential that the operator save the copy of the PDS after executing the 
stand-alone dump. You as the system programmer, or the IBM CE/SE will then be 
able to print out all or any part of the PDS to complete problem analysis. 
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Aids provided by the Operator's Console 



ALTER/DISPLAY 
FEATURE (ALL MODELS) 



The ALTER/DISPLAY facility allows the operator to dump or display, and 

change the contents of various parts of the CPU storage (depending on the CPU 

Model) and of real or virtual storage. 

For the purpose of hands-on debugging, the following areas may need to 

be displayed: 

Any selected area of virtual storage 

General registers 

Floating-point registers 

Current PSW 

Control registers 



When to use 

ALTER/DISPLAY is useful for hands-on debugging, and enables the operator to 
obtain information about the system at the time a malfunction occurs. It must 
be used whenever a display of the low address storage is required, for example, 
to record a wait state message (see E-3 in this section). 

Flowcharts in section 3 indicate when to use this facility, and which option to 
choose for a particular system malfunction 

CAUTION 

The effect on the operation of programs currently running in the system that are 
time dependent, for example, a program using MICR or teleprocessing as input/ 
output, must be considered before using this serviceability aid. 
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Aids provided by the Operator's Console 



How to use this feature 



ALTER/DISPLAY 

MODELS 135 

AND 145 



INTVN 
REQD 



NOT 
READY 



CANCEL 



ALT/DISP 
MODE 



ALTER/ 
DISPLAY 



0)00000000000 ~ 
00000000000 



RETURN 



E00000000000 



SHIFT 




[ 



Spacebar 



J 



► 



Indicator 


Condition 


INTVN 
REQD 


The console printer is out of forms or the 
PR-KB is not ready. 


ALT/DISP 
MODE 


A request for an alter/display operation was 
accepted. 


ALARM 


An alarm command was issued, and manual 
intervention is required by the operator. 


PROCEED 


The PR-KB is unlocked and ready to accept 
characters. This indicator is turned on by the 
ALTER/DISPLAY key or by a read command. 


REQUEST 
PENDING 


A request operation was initiated. The indicator 
is turned off when the attention status is 
accepted by the CPU. 



Indicator 



► 
► 



Key 


Function 


NOT READY 


Places the console printer in a not-ready condition. 


CANCEL 


Used to terminate a read command when the operator has 
made an error in data entry. Normally, the program will 
issue the same read command again. 


READY 


Places the PR-KB in the ready state when forms are in the 
printer and the cover is closed. 


ALTER/ 
DISPLAY 


Requests or ends an alter/display operation. When used to 
end an alter/display operation, the PR-KB remains in alter 
/display mode. 


END 


Terminates a read, write, or alter /display operation. 


ALARM 
RESET 


Resets the ALARM indicator. 


REQUEST 


Initiates the attention routine to enable operator/ 
system communication 



Key 



o 



Indicators and Control Keys (3210 and 3215 printer keyboard) 
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Aids provided by the Operator's Console 



ALTER/DISPLAY 
MODELS 135 145 
AND 115-11 
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Table D- 1 below summarizes the ALTER/DISPLAY options, that can be selected 
when using the flowchart shown in D - 1 -F. 




Mnemonic 


Storage 
Area 


Address Range 




Alter 


Display 




AM 




DM 




Real address area 


000000-03BFFF* 




AV 




DV 




Virtual address area 


000000-1 6 megabytes 




t 




DS 




Control storage 


0000-DFFE*+ 




AG 




DG 




General register 


0-F 




AF 




DF 




Floating-point register 


0,2,4,6 




AP 




DP 




PSW 


None 




AC 




DC 




Control register 


0-F 




AK 




DK 




Storage key 


000000-03BFFF* 




AX 




DX 




Transmission speedtt 


1—8 (line number) 





Use address length shown; if necessary, fill-up with leading zeros. 

* Model-dependent. 

t You cannot alter control storage data. 

+ Control storage addresses are not continuous. For control storage address to be 
valid, leftmost (fourth-highest) digit must be: 

1 . For 24K control storage size; 0—5 

2. For 36K control storage size, 0—5, 8, A, or D(hex) 

3. For 48K control storage size, 0—5 or 8— D(hex). 

tt Line speed can only be changed if, with your ICA feature, you have the SDA 
II subfeature with clocking provided by the Model 135. = 600 bits per second, 
1 = 1200 bits per second. 



Table D-l. Options for the ALTER/DISPLAY feature. 






Notes: When the operation is ended with the ALTER /DISPLA Y key, the keyboard 
remains in ALTER /DISPLAY mode (ALT/DISP MODE indicator on). When the 
operation is terminated with the END key, ALTER/DISPLA Y mode is terminated. 

For ALTER/DISPLA Y of general and floating-point registers, a wraparound is 
performed (F to for general registers, and 6 to for floating-point registers). 
When addressing virtual storage, either a word or byte address may be used. If the 
starting address is not on a word boundary, the console printer spaces and aligns at 
the byte addressed. 
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Aids provided by the Operator's Console 



^ih, # ,i' 



Yes 



Start 



Press STOP and wait until 
MAN indicator turns on 



Press ALTER/DISPLAY 
(printer-keyboard) and wait 
until PROCEED Light 
(printer-keyboard) turns on 



Type two-character 
mnemonic and hex address 



Specifies: 

1. Alter or display 

2. Storage area 

3. Address in virtual 
storage 

See table D-1 

for choice of options. 




No 



Type hex data to alter 
information as required. 
(See "Format of Printout. 




Display — printer-keyboard 
print required data. (See 
"Format of Printout." 



Press END 
(printer-keyboard) 



ALTER/DISPLAY 

MODELS 135, 145, 

AND 155-11 



D-1-F 



Carriage return and line feed occurs. 
ALT/DISP MODE indicator turns on. 



Data may be entered, one digit at a 
time, using the space bar to skip over 
positions not being altered. The data 
in the skipped-over positions remains 
unchanged and is printed out each 
time the space bar is operated. To 
end the operation, press the END or 
the ALTER/DISPLAY key. 



Data is printed starting at the address 
specified and continued until the 
END or the ALTER/DISPLAY key is 
pressed. (Contents of locations or 
registers are not affected.) 



Line feed occurs; ALT/DISP MODE 
indicator turns off; system is in the 
manual state. 



To resume processing 
press START 
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Aids provided by the Operator's Console 

Format of printout 



ALTER/DISPLAY 
MODELS 135, 145, 
AND 155-11 



Starting at the specified address, the display is printed in groups of eight characters 
with up to eight groups per line. Depending on your starting address, the initial 
group might not contain eight characters. When general and floating-point registers 
are displayed, the address sequence 'wraps,' that is, the highest available address 
is followed by the lowest address (zero). 

When altering, enter new hex characters in the positions occupied by the characters 
to be replaced. Reach the required positions by repeating characters to be 
retained. 

Examples are shown below of the printout (reduced in size) from a 3215 console 
printer by using the ALTER/DISPLAY feature. 

Example 1 

This example shows a display of the 

• current PSW (DP) 

• general purpose registers (DG) 

• control registers and 

• low address storage. 



..I lJfc 



074I.K)000 00089 ABC 

.HE 

004000FF 0000E640 
O.Q.0.0.EE.EE .0.00.0.0.0.00. 

.hq 

O0089A7C 00089E80 
..0.0.08.9.9.7.8 .00.0B9.Ea0.. 



IIW....0.00000. 
00000000 

..07..4D.0.0.0.0 

4000E6F0 

..O.4.0.C.00.0.O 

00000540 

.0000.0.000 

00000000 

.0.0.00.0.0.00 

00000000 
..0.00.0.000.0 

ooooooo~o— 

.0.0.0.0.0.0.0.0 

00000000 



00000000 
..00.0a9.Bi2. 
OC 00 00 00 
OOOOOBCC... 
00000000 
.00.0.00.000.. 
00000000 
.00.0.000.00.. 
00000000 
.00.0.0.0.0.00.. 
-oooo 00 00 
..oooooooo.. 

00000000 



FFFFFFFF 
.0.00.0.0.0.0.0.. 



00089E78 

0.00.9.E4.4.7. 



oooooooo 

..0.40.C.O0OO... 

400070B8 
..0.OO.COO0O... 

00020007 
.2.000.00.6.0.. 

OOOOOOOO 

..oooooooo.. 
oooooooo 

.0.00.0.000.0.. 

oooooooo 

..oooooooo.. 

oooooooo 



FFFFFFFF 
0.0.000.0.00. 



00089EAC 
...400a9F5.A.. 



OOOOOOOO 
...0.0.00.09.&2.. 

oooooooo 
ooooashc. 

00040000 
...0.000.0.2CG.. 

oooooooo 
...oooooooo.. 
oooooooo 
oooooooo.. 
oooooooo 
.. oooooooo.. 
oooooooo 



oooooooo 
oooooooo.. 



00089E80 
4008AD9A 



OOOOOOOO 

..oooooooo... 

FAE40800 
04080000 
4009D840 

oooooooo.. 

OOOOOOOO 
..OOOOOOOO 

oooooooo 
..oooooooo... 

oooooooo 
...oooooooo... 

oooooooo 



oooooooo 
oooooooo.. 



000000 i9 
000&92EO.. 



00004450 
OOOOOOOO-. 
020AFE5B 
00O0M3A 
00020000 
-OOOOOIOO.. 
OOOOOOOO 

oooooooo. 
oooooooo 
oooooooo 
oooooooo 
oooooooo.. 
oooooooo 



oooooooo 

£20.00000 



A0089EDC 
80089EF0 



OOOOOOOO 
O7OF20O0 
040C0000 
O4OC0O00 
OOOOOOOO 
00000430; 
OOOOOOOO 

oooooooo. 
oooooooo 
oooooooo 
oooooooo 

■ OOOOOOOO-- 



OOOOOOOO 
0000.0200.. 



0008A157 
00089AAO.- 



OOOOOOOO 
0000090C 
00OOOC14 
0OO0OE1O 
OOOOOiCC 
OOOOOO-Od 

oooooooo 

..OOOOOO-OO- 
OOOOOOOO 
O<iO00C)X)O.. 
OOOOOOOO 

..oooooooo. 



(£xfa, 



Example 2 

In this example, the contents of control registers 9,10, and 1 1 were altered. First 
the operator displaced the contents by using the DC option. Then using the AC 
option, he entered the new data. To ensure that the data change was successful, 
the operator has displayed the control registers again. 





m 






















DC 9 
: OF123D00 


OOOOOOOO 


90000000 


OOOOOOOO 


OOOOOOOO 


C2000000 


00000200 

oooooooo 


004000FF 
OOOOEOOO 






m 


; O000E640 


FFFFFFFF 


iFFFFFFFF 


OOOOOOOO 


OOOOOOOO 


oooooooo 




; AC 9 

; 00OO00AA 


AA89$300 


DEF 12301 












• 

• 


I DC 9 

r OOOOOOAA 

! 0000E640 

" T 

1 
















Kffig?3386 
FFFFFFFF 


DEF12301 
FFFFFFFF 


OOOOOOOO 
OOOOOOOO 


oooooooo 
oooooooo 


C2000000 

oooooooo 


00000200 

oooooooo 


004000FF 
OOOOEOOO 










C^Tx^/r^ 
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Error Messages 

An ALTER/DISPLAY operation is terminated when an ALTER/DISPLAY error 
message occurs or when the end of a storage area or register is reached. 



Aids provided by the Operator's Console 

ALTER/DISPLAY 

MODELS 135, 145, 

AND 155-11 



Model 135 Alter /Display Error 

Invalid character: An invalid character is created when you use the mnemonic not 
shown in the table, when you address a feature not installed on your system, or 
when you enter an address or data character that is not a hex digit. An invalid 
character is ignored (no print or space occurs). Continue by entering the correct 
character— it is not necessary to restart the whole operation. 




© 



Invalid address: An invalid address is created when your address is not addressable 
location (the address might be outside the storage capacity of your system or you 
may be trying to address a virtual address that is not in the real address area) or 
when you address an ICA line either not installed or not fitted with the SDA II 
sub feature with clocking by the Model 135. An invalid address terminates the 
operation with the message '?ADR.' You must start again. 

Invalid Data: When changing the transmission speed for a communications link 
(AX or DX mnemonics), the only valid data characters are '0' or '1 .' When any 
other hex character is entered, the operation is terminated with the message 
'?DATA.' The transmission speed remains unaltered. 

Invalid -Format PSW: When you enter an invalid -format PSW, the PSW is 
altered but an interruption is generated when the invalid PSW is subsequently 
used. 



Model 145 Alter/Display Error 

Invalid Character: INVAL CHAR is printed if one of the following occurs: 

• The first character of a mnemonic is not A, D, or T (see Keyboard Test 
Mode Operation). 

• The second character is not M, S, L, K, C, G, F, or P. S and L are reserved 
for service personnel. 

• An invalid digit is typed when addressing or altering data. 

• The CANCEL key is pressed. 



Invalid Address: INVAL ADDR is printed if one of the following errors occurs: 

• Invalid starting address. 

• The updated address exceeds the capacity of specified storage. 

• The operator performs an AS or AL operation. 

• You may be trying to address a virtual address that is not in the real 
address area. 



Model 115-11 

As a result of the editing function, the following indications are given: 

1. If an invalid character is detected in the op code, storage mnemonic, or hex digit 
(0-9 and A-F), the printer does not respond. The operator can then rekey the 
correct character. 

2. If an invalid address (beyond the physical storage) is detected the error message '?' 
is printed. 

3. If an alter PSW operation is invalid, the PSW is restored to its original value 
and '?' is printed. 
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Aids provided by the Operator's Console 



ALTER/DISPLAY 
MODELS 115 AND 125 



The ALTER/DISPLAY facility allows the operator to display or change the 
contents of the following parts of the CPU (Central Processing Unit), and of real 
or virtual storage areas: 

• General registers 

• Floating-point registers 

• Current PSW 

• Control registers 

• Protection keys 

• Real storage areas 

• Virtual storage areas. 



A "hard copy" of all information displayed on SYSLOG can be obtained on a 
Model 115 and 125 with a 5213 printer attached by pressing the COPY key after the 
information is displayed. 

CAUTION 

The effect on the operation of programs currently running in the system that are 
time dependent, for example a program using MICR or teleprocessing as input/ 
output, must be considered before using this serviceability aid. 
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Aids provided by the Operator's Console 



How to use 



Before the ALTER/DISPLAY feature can be used, the mode select display shown 
below must be brought to the screen by pressing the MODE SELECT key. 



ALTER/DISPLAY 
MODELS 115 AND 125 



MODE SELECTION 



R SYSTEM RESET 

<-- ADDRESS COMPARE 

PROGRAM LOAD 
T INTERVAL TIMER 
K CHECK-CONTROL 
D STORAGE DUMP 
E ICA LINE MODES 
MODE SPECIFICATION: 



A ALTER/DISPLAY 

I INSTRUCTION STEP 

P RESTART 

M MAINTENANCE 

S STORE STATUS 

U SAVE USAGE COUNTERS 




To select the ALTER/DISPLAY feature: 

1. Type A into the mode select display. 

2. Press the ENTER key. 

The ALTER/DISPLAY picture as shown below is brought to the screen and 
shows those parts of the CPU and real/virtual address areas that can be altered 
and/or displayed. 






* ALTER/DISPLAY * 

GENERAL REGISTERS 
C CONTROL REGISTERS 
P CURRENT PSW 

FLOATING POINT REGISTERS STORAGE ADDRESS 
K PROTECTION KEY 000000 - FFFFFF 

M MAIN STORAGE REAL 000000 - FFFFFF 

V MAIN STORAGE VIRTUAL 000000 - FFFFFF 



^P 



MODE SPECIFICATION: 



To select a particular display: 

1. Type in the associated mnemonic according to the instruction given in the 
next flowchart. 

2. Press the ENTER key. 

Before ENTER is pressed, you can still change your input by using the cursor 
keys and entering the changes in the usual way. As soon as ENTER is pressed, 
the new data replaces the old. The display remains on the screen and the 
cursor is at the next ALTER/DISPLAY line. Because there is an A (for 
ALTER/DISPLAY on this line, you need only enter F (for floating point 
registers) or P (for PSW), and so on. 
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Aids provided by the Operator's Console 

ALTER/DISPLAY 
MODELS 115 AND 125 



G 

GENERAL 

REGISTERS 


To display: 

1 . Type G into the alter /display picture. 

2. Press ENTER. 

All general registers appear at once. 


F 

FLOATING- 
POINT 
REGISTERS 


To display: 

1 . Type F into the alter/display picture. 

2. Press ENTER. 

All floating-point registers appear at once. 


P 

CURRENT PSW 


To display: 

1 . Type P into the alter/display picture. 

2. Press ENTER. 

The current PSW is displayed in binary notation, except for the 
instruction address, which is in hex. BC or EG mode is indicated in the 
machine status area, line 14, and in the E-bit in the PSW. 

o BC Mode: The system is in basic control mode when the E-bit 

is zero, 
o EC Mode: The system is in extended control mode when the E-bit 
is 1. 


C 

CONTROL 

REGISTERS 


To display: 

1 . Type C into the alter/display picture. 

2. Press ENTER. 

All control registers appear at once. 


K 

PROTECTION 

KEY 


To display: 

1. Type K into the alter/display picture. 

2. Type in the main storage address in hex. 

3. Press ENTER. 

In the protection key display: 
o The address is in hex. 
o The key is in binary. 

o The reference (R), the change (C), and the protection (P) bits 
are in binary. 


M 

MAIN 
STORAGE 
REAL 


To display: 

1 . Type M into the alter/display picture. 

2. Type in the main storage address in hex. 

3. Press ENTER. 

The display shows 32 halfwords of main storage at once. The Y characters 
in the format illustration represent, in hex, the main storage address with- 
out its low-order digit. The missing low order digit of the address is shown 
above each leftmost byte of each half word. 


V 

MAIN 
STORAGE 
VIRTUAL 


To display: 

1 . Type V into the alter/display picture. 

2. Type in the address. 

3. Press ENTER. 

The display shows 32 halfwords of virtual storage at once. The R char- 



J* 



\^y 



Examples following the flowchart opposite show the format of the various 
displays and describe error indications where applicable. 

Table D-2 Options for the ALTER/DISPLAY console feature 
(Models 115 and 125) 
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Press MODE SELECT 






Type in A and press 
ENTER 



Specify the display 
required by typing in the 
associated mnemonic 



Press ENTER 



Figure D-2 parts 1 and 2, 
illustrate the displays asso- 
ciated with the mnemonics, 
and describe error indica- 
tions where applicable. 



NO 



o 



Make a note of the required 
instruction address and 
contents displayed. 




To alter any of the dis- 
played contents, move the 
cursor under the first digit 
and type in the new data. 



Press ENTER 



YES 



YES 



Press MODE SELECT twice 




Press CANCEL 



Aids provided by the Operator's Console 

ALTER/DISPLAY 
MODELS 115 AND 125 



If you have a display, selected from the 
Alter/Display set or other service function, 
and then press MODE SELECT, the 
Alter/Display picture will appear. To get 
the mode select picture you have to press 
MODE SELECT twice 



Refer to the list of mnemonics and 
instructions given on the opposite 
page. 



D-2-F 



The first digit can be hexadecimal 
or binary, depending the display 
specified. The new contents appears 
on the line below the original until 
the ENTER key is pressed. 



The original display is replaced to 
display the new contents. 



The last picture of the operating 
system is brought back to the screen 



Select the 
new mode 



o 



To resume processing 
Press START 
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Aids provided by the Operator's Console 



ALTER/DISPLAY 
MODELS 115 AND 125 



Error messages 

If logical errors are made while altering 

the current PSW, one or any of the 

following error indications may be 

displayed: 

1.EC-PSW ERROR 

2. INVALID ADDRESS LOADED 

3. ADDRESS NOT TRANSLATE- 
ABLE 

Message 1 indicates PSW rejection, 
which is caused if bit 1 2 of the PSW 
is set to zero. Messages 2 and 3 
indicate that the PSW has been loaded, 
but a program check will occur when 
an attempt is made to continue 
operation. 

Message 3 occurs in case of invalid 
page or segment table address 
specification exception. 



Format of displays and error indications 

The following illustrations show the amount and format of information displayed 
with the associated mnemonic. When a wrong character (either a non-hex or a non- 
binary as the case may be) is entered, INVALID CHARACTER appears. The 
cursor marks the first invalid character. 



GENERAL REGISTERS 



ALTER/DISPLAY GENERAL REGISTERS (HEXADECIMAL) 



0000 0000 1 0000 0000 2 0000 0000 3 0000 0000 



4 0000 0000 5 0000 0000 6 0000 0000 7 0000 0000 



8 0000 0000 9 0000 0000 A 0000 0000 B 0000 0000 



C 0000 0000 D 0000 0000 E 0000 0000 F 0000 0000 



NEXT ALTER/DISPLAY: A 



o 



FLOATING POINT REGISTERS 



ALTER/DISPLAY FLOATING POINT REGISTERS (HEX) 



0000 0000 0000 0000 



2 0000 0000 0000 0000 






4 0000 0000 0000 0000 



6 0000 0000 0000 0000 



NEXT ALTER/DISPLAY: A 



Current PSW 



ALTER/DISPLAY CURRENT PSW 



SYST.MASK KEY EMWP ILC CC PROGRMASK 

0000 0000 0000 0000 00 00 0000 



INSTRUCTION ADDRESS: 000000 
ADDRESS IN HEX. OTHER DATA IN BINARY 



NEXT ALTER/DISPLAY: A 



Figure D-2, part 1 of 2. Format of the displays for Models 115 and 125. 



^fcii^ 
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CONTROL REGISTERS 



ALTER/DISPLAY CONTROL REGISTERS (HEXADECIMAL) 



0000 00E0 1 0000 0000 3 FFFF FFFF 3 FFFF FFFF 
4 0000 0000 5 0000 0000 6 0000 0000 7 0000 0000 



Aids provided by the Operator's Console 

ALTER/DISPLAY 
MODELS 115 AND 125 



8 0000 0000 9 0000 0000 A 0000 0000 B 0000 0000 
C 0000 0000 D 0000 0000 E C200 0000 F 0000 0200 



NEXT ALTER/DISPLAY: A 



K PROTECTION KEY 



ALTER/DISPLAY PROTECTION KEY 




ADDRESS: 00002F KEY: 0000 



NEXT ALTER/DISPLAY: A 



Error messages 

INVALID ADDRESS appears if the address 
is larger than the real storage size. 

The address has to be typed in with leading 
zeros. When selecting the alter /display 
protection key display, do not use any 
commas or blanks. 



MAIN STORAGE REAL 



ALTER/DISPLAY MAIN STORAGE REAL (HEXADECIMAL) 



02468ACE 
00012 0000 0000 0000 0000 0000 0000 0000 0000 



00013 0000 0000 0000 0000 0000 0000 0000 0000 

00014 0000 0000 0000 0000 0000 0000 0000 0000 



00015 0000 0000 0000 0000 0000 0000 0000 0000 



NEXT ALTER/DISPLAY: A 



V ALTER/DISPLAY MAIN STORAGE VIRTUAL 



■ I 



ALTER/DISPLAY MAIN STORAGE VIRTUAL (HEX) 



REAL: 03E28 2 4 6 



61A94 D0E3 AB13 5478 4ABE 0000 0000 0000 0000 



61A95 0000 0000 0000 0000 0000 0000 0000 0000 



61A96 0000 0000 0000 0000 0000 0000 0000 0000 



61A97 0000 0000 0000 0000 0000 0000 0000 0000 



NEXT ALTER/DISPLAY: A 



Figure D-2, part 2 of 2. Format of the displays for Models 115 and 125 



Error messages 

If the contents of the virtual address 
entered is not in real storage the 
virtual storage area will not be 
displayed. Instead one of the following 
messages will be displayed: 
OUTSIDE PAGE TABLE 
OUTSIDE SEGMENT TABLE 
PAGE ENTRY INVALID 
SEGMENT ENTRY INVALID 
SPECIFICATION EXCEPTION 
ADDRESSING EXCEPTION 



Serviceability Aids. 2.143 



Aids provided by the Operator's Console 



ALTER/DISPLAY 
MODEL 158 



The ALTER/DISPLAY facility allows the operator to display or change the 
contents of the following parts of the CPU (Central Processing Unit), and of real 
or virtual storage areas: 



General registers 
Floating-point registers 
Current PSW 
Control registers 
Protection keys 
Real storage areas 
Virtual storage areas 



Real Channel UCWs 
Logical Channel UCWs 
Active UCWs 
CPU Local Storage 
I/O UCW Local Storage 
I/O Buffer Local Storage 






How to use 

The ALTER/DISPLAY frame, shown below, can be entered only from the 
MANUAL or SERVICE frame when the CPU is in the stopped (manual) state. 



FUNCTION 

■ A-ENABLE ALTER 

■ D-DISPLAY 
FACILITY 

■ M-MAIN STOR REAL 
•V -MAIN STOR VIRT 

■ K-MAIN STOR KEYS 

■ E-UCW REAL 
■U-UCW LOGICAL 

■ T-UCW ACTIVE 
« L-CPU LOCAL 

■ I -I/O LOCAL 

■ B-l/O BUFFER 

■ C-CTRL REGS 

■ G-GENERAL REGS 

■ F-FLT PT REGS 

■ P-PSW 

KEY IN/ADDRESS 

XX "000000 
FRAME CONTROL 
> NEW LINE 

■ ERASE INPUT 



■ COPY PSW=XXXXXXXX XXXXXXXX SV 



CURSOR 
CONTROLS 






A procedure for using this facility is shown in the flowchart on the opposite page. 

Error Indications 

All address characters are checked as they are entered for hex values 0-F. 
Invalid characters are not displayed and the console alarm sounds. 

If the cursor stays in the reset position (under the Y in Key In/ Address) and if the 
console alarm sounds, an invalid function code has been entered. A valid function 
code must be entered before the cursor will reposition to the right (one position). 

Printing displayed information 

A "hard copy" of all information displayed can be obtained on a Model 158 with 
a 3213 printer attached by pressing the COPY key after the information is displayed. 

Note however, that the following frames cannot be printed: 

• PROGRAM 

• ALTER/DISPLAY 

• INDEX 

(and when using the ALTER facility, only lines that have been changed by entering 
new data will be printed on the 3213 printer.) 

CAUTION 

The effect on the operation of programs currently running in the system that are 
time dependent, for dxample a program using MICR or teleprocessing as input 
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Aids provided by the Operator's console 



O 







If the function requires 
an address the cursor 
moves to the first digit 
under KEY IN/ADDRESS| 
(see the note below) 

The cursor moves to 
the right until the 
address is complete fiP^ 

The cursor will pos- |§ i; . ; . 
ition itself under the 
first digit of the con- §|§| 
tents of the location |§§§| 
at the specified address p* 

The cursor will pos- 
ition itself at the next 
digit that can be altered 



Press STOP, 

then 

Press MODESEL 



ALTER/DISPLAY 
MODEL 158, 



Type in F3, or press 
light pen to lozenge. 
3-ALTER/DISPLAY 



ALTER 




I The MANUAL frame will be 
Idisplayed 

|The ALTER/DISPLAY frame 
| will be displayed as shown on 
ithe opposite page 



DISPLAY 



Type in A or press 
light pen to lozenge 
■ A-ALTER 



Type in the associated 
mnemonic for the 
function to be altered, or 
use the light pen. 



Type in an address or 
use the light pen 



Press ENTER or COPY, 
or use light pen 



Type in new data or 
use the light pen. 



Press ENTER, or COPY, 
or use light pen. 



Type in D or press 
light pen to lozenge 
■ D-D ISP LAY 



Type in the associated 
mnemonic for the 
function to be dis- 
played, or use the 
light pen. 



If locations are to be 
displayed type in, or use 
light pen to enter the 
address in six hex digits 



If the function requires 
an address the cursor moves 
|to the first digit under KEY 
| IN/ADDRESS (see note 
below) 



The cursor moves to the 
right until the address is 
complete 




Press ENTER, or COPY 
or press light pen to 
lozenge ■ COPY. 



Yes 



Press CANCEL 





Note 1: 

An address is not required to 

alter or display the following: 

• Control registers 

• General purpose registers 

• Floating point registers 

• Program status word 



The program frame 
\ displayed prior to this 
operation is re-displayed 



Press START 



J 






When using COPY and ENTER: 

Using COPY will only produce a "hard copy" of lines that have been changed by entering new data. 

Using ENTER in display mode will not produce a "hard copy". 
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Aids provided by the Operator's Console 



INSTRUCTION 
STEPPING 
(ALL MODELS) 



This console facility allows the operator to check and obtain a hard copy of each 
instruction address executed during program operation. 

Combining this facility with the console printer ALTER/DISPLAY feature 
described in D-l of this section, provides a procedure to trace and record the path 
of a short loop. 

Note: The different types of loops and their causes are described in Section 1. 



When to use (all Models) 

This facility should be used when the system malfunction prevents the use of 
SDAIDS to trace the loop. It is also useful during hands-on debugging when only 
small parts of a program require accurate program flow analysis. 

Flowcharts in Section 3 indicate to the operator when a loop is to be traced using 
this console facility. 



INSTRUCTION STEPPING 
MODELS 135, 145, 
AND 155-11 



How to use 

A procedure for tracing and recording the path of a loop using the instruction step 
facility of the Models 135, 145 and 155-11 is shown in the flowchart opposite. 



KJ 
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Aids provided by the Operator's Console 

INSTRUCTION STEPPING 

MODELS 135, 145, 

AND 115-11 



Start 



Press STOP and wait until 
MAN indicator turns on 



Set RATE switch to 
INSTRUCTION STEP 



\J 



Press ALTER /DISPLAY 
(printer-keyboard) and 
wait until PROCEED light 
(printer-keyboard) turns on 



Carrier return and line feed occurs. ALT/DISP 
MODE light (printer-keyboard) turns on. 
If this does not occur, press CANCEL on the 
printer-keyboard, and press the ALTER/DISPLAY 
key again. 




Type in DP 
press END 



The contents of the current PSW 
is printed 




NO 



Press START and wait until 
SYS indicator turns off 



Set RATE switch 
to PROCESS 



To continue system 

operation, press the 

„ START key 



The procedure for tracing a loop using instruction step method 
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Aids provided by the Operator's Console 

How to use 



INSTRUCTION STEPPING 
MODELS 115 AND 125 



INSTRUCTION STEP 

offers two modes: 
IandP 



The INSTRUCTION STEP display allows the operator to check and make a note 
of each instruction address during program operation. 

Making a note of the instruction addresses executed each time the START button 
is pressed provides a procedure to trace and record the path of a short loop. 

To select the instruction step display shown below: 

1. Type I into the mode select display. 

2. Press ENTER. 



ft 



INSTRUCTION STEP 



OPERATION RATE 



I INSTRUCTION STEP 
P PROCESS 



I INSTRUCTION STEP 



P PROCESS 



.If I is typed into the instruction step display and ENTER is pressed, the new data 
can be seen as soon as the stop occurs. Line 14 (in the machine status area) shows 
the address and the data at this address. 

.As soon as START is pressed the screen is returned to the operating system and 
operating messages can be traced with each step. Instruction step mode is indicated 
by I-STEP on line 15 (in the machine status area). Entering P is used to end the 
instruction step mode. 

1. Type in P. 

2. Press ENTER 

The last picture of the operating system is brought back to the screen. 
Press START to continue processing. 



O 
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Aids provided by the Operator's Console 

INSTRUCTION STEPPING 
MODELS 115 AND 125' 



Press MODE SELECT 



Type in II and press ENTER 






The machine stops and the previous 
display disappears 



Press START 
Wait until MAN appears 
on line 13 and l-STEP 
appears on line 14 



When START is pressed, the instruction 
step display disappears and the screen 
is returned to the operating system. 
For each depression of START, one 
machine-language instruction is processed. 
CPU then services any pending 
interruptions before entering manual state. 



Make a note of the 
instruction address and con- 
tents displayed on line 14 



Yes 





No 



Press MODE SELECT 



Type in IP and press 
ENTER 



(Fast Selection) 

Instruction step mode is cancelled. 



To resume processing 
press START 



The procedure for tracing a loop using the instruction step method 
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Aids provided by the Operator's Console 



INSTRUCTION 
STEPPING 
MODEL 158 



The INSTRUCTION STEP display allows the operator to check and make a note 
of, or obtain a "hard copy" of each instruction address during program operation. 

Making a note of the instruction addresses executed each time the START button 
is pressed provides a procedure to trace and record the path of a short loop. 

How to use 

With the manual fram displayed, shown below, after pressing MODE SEL, the 
R-RATE switch must be set to I-STEP by either typing in R2 or by pressing the 
light pen to lozenge ■ 2-I-STEP. The selection is indicated by an arrow displayed as 
shown in the example below. 







The instruction address of the current instruction will be in the address part of 
the PSW displayed on line 25. 

Pressing the START key will cause the CPU to execute the next instruction in 
logical sequence, the address of which will be displayed in the PSW as before. 

In display mode of operation a "hard copy" of the PSW displayed can be obtained 
on the 3213 printer, if attached, by pressing the COPY key or by pressing the 
light pen to lozenge COPY. 

To return to normal CPU processing rate, type in Rl or hold the light pen against 
■ 1 -PROCESS and press MODE SEL followed by START. 
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vV 



Aids provided by the Operator's Console 



^^Min^ 



INSTRUCTION 

STEPPING 

MODEL 158 



c 



Press STOP 



3 



Press MODE SEL 



The MANUAL frame is 
displayed 



Type in R2, or press 
light pen to lozenge 
■ 2-l-STEP 



o 



Press START 



Press COPY 

or press light pen 

to lozenge ■ COPY 



The word SYS will be displayed 
momentarily, and the instruction 
address will be displayed in the 
PSWon line 25 



A "Hard copy" of the frame 
displayed can be obtained on 
the 3213 printer, if attached 



Yes 





No 



Type in R1 or press 
light pen to lozenge 
■ 1 -Process 




Yes 



No 



Press MODE SEL 
or CANCEL 



Select new mode 



C 



Press START 



D 






The procedure for tracing a loop using the instruction step method on the Model 158 
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Aids provided by the Operator's Console 



STOP ON ADDRESS 

COMPARE 

(ALL MODELS) 



This facility enables you to stop all system activity at any selected storage address 
during system operation. Two methods are provided on the System/370 that 
enable both hardware and software-controlled stops: 

1. By using switches on the system control panel 

2. By using the SDAID stop on event facility. 

For the Models 145 and 155-1 1 the system control panel switches enable a stop 
on real or virtual address. 

The Model 115, 125 and 135 have system control panel switches that do not allow 
for a stop on a virtual address. 

Stop on event for all models is described under SDAIDS, Section 2-B-8. A flow- 
chart in Section 2-B- 10 shows how to initiate and execute this aid. 



o 



When to use (all Models) 

This facility is a hands-on debugging aid for the programmer, and permits him to 
stop system operations at selected addresses in the program listings. He can use it, 
for example, in conjunction with either the ALTER, DSPLY and DUMP commands, 
or the console ALTER/DISPLAY feature, to change the contents or display 
particular areas of storage at selected addresses in a program. The operator is also 
able to use this facility if, for example, the programmer requests a dump of 
certain storage locations at particular points in a program during execution of 
the program. 



STOP ON ADDRESS 
COMPARE 
MODELS 135, 145, 
AND 115-11 



How to use 

Four switches on the system control panel are used during address compare 
operations: 

• ADDRESS COMPARE CONTROL (Toggle) 

• ADDRESS COMPARE (Rotary) 

• STORAGE SELECT (Rotary) 

• INTERVAL TIMER (Toggle) . 

The flowchart opposite shows the procedure for stop on address compare applicable 
to System/370 Models 135, 145 and 155-1 1 . However, because the ADDRESS 
COMPARE rotary switch differs between models, the IBM operating procedures 
for the model on which the operation is to be executed must be consulted. 

The flowchart on the following page shows how to invoke the displays required 
to execute the "Stop on Address Compare" on the Models 115 and 125. 



c 



-J 
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Aids provided by the Operator's Console 

STOP ON ADDRESS 

COMPARE 

MODELS 135, 145, 

AND 155-11 






Start 



3 



Press STOP 



\ 



Ensure STORAGE SELECT 
is set to MAIN STORAGE 



Set INTERVAL TIMER 
to DISABLE 



Set rotary switches A 
through E (STORAGE ADD- 
RESS) to desired stop 



Set ADDRESS COMPARE 
to select desired condition 
for stop, for example, ANY 



Set ADDRESS COMPARE 
CONTROL three-position 
lever switch to STOP 



Press START 



> 



Address 

Comparison 

Stopping 



Switch positions for selecting the 
conditions for the stop are different for 
each of the System/370 Models. Consult 
Compare Type Selection on the next 
two pages and the note below. 



Model 135 and 145 
When address accessed by 
CPU matches selected address 
CPU stops at the end of in- 
struction in progress. 



Set: 

1. ADDRESS COMPARE 
to ANY 

2. ADDRESS COMPARE 
CONTROL to SYNC/ 
NORMAL 

3. INTERVAL TIMER to 
NORMAL (if required) 



Press START 




> 



Resumption 
of 

Normal 
Processing 



Note: 

See ADDRESS COMPARE and 
ADDRESS COMPARE CONTROL 
CONTROL switch setting for each 
System/370 model as described in the 
IBM-supplied Operating Procedures 
manual belonging to the system. 



J 



A procedure for using the stop on address compare facility. 
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Aids provided by the Operator's Console 



STOP ON ADDRESS 
COMPARE 
MODELS 135, 145, 
AND 155-11 



Compare type selection (Model 135) 



ADDRESS COMPARE 



ANY 



DATA 
STORE 



o|C 




o|/0 



DATA STORE: 

! A match occurs when the selected location is addressed to store data. 

ANY: 

\ The normal operating position — a match occurs when the selected location is 
addressed for any type of operation 

ilC: 

! A match occurs when the selected location is addressed by an instruction 

j I/O: 

! A match occurs when the selected location is addressed for an I/O data transfer 



Compare type selection (Model 155-11! 



| ADDRESS COMPARE 

ANY 
FETCH o^-fr^o IAR 



STORE 




ANY (Real Address) 

This position of the switch is used for normal program processing. With the switch 
in this position, a match occurs for main storage access when the storage address 
matches the address set in console switches CDEFGH. 

FETCH 

This position causes a match when the storage address matches the address set in 
console switches CDEFGH, and the operation is a data fetch from main storage. 

STORE 

This position allows a match when the storage address matches the address set in 
console switches CDEFGH during a data store operation. 

IAR 

This position of the switch allows a match when the IAR (instruction address 
register) address matches the address set in console switches CDEFGH. 

I/O (Input/Output) 

This position of the switch allows a match when the storage address matches the 
address set in console switches CDEFGH, and the operation is a data store or fetch 
for an I/O operation. 



l \^J 






2.154 Serviceability Aids. 



Aids provided by the Operator's Console 



Compare type selection (Model 145) 
ANY (Logical Address) 

This position of the switch allows a match when the logical 
main storage address used to access storage matches the f||ff|, 

address set in console switches CDEFGH. 

ANY (Real Address) 

This position of the switch is used for normal program 
processing. With the switch in this position, a match occurs 
for main storage access when the storage address matches 
the address set in console switches CDEFGH. 

DATA STORE 

This position allows a match when the sotrage address 
matches the address set in console switches CDEFGH during 
a data store operation. 

I/O (INPUT/OUTPUT) 

This position of the switch allows a match when the storage 
address matches the address set in conssole switches 
CDEFGH, and the operation is storing or fetching data for 
an I/O operation. 

I-COUNTER (Real or Logical Address) 

This position causes a match when the real or logical main 
storage address matches the address in console switches 
CDEFGH, and the operation is an instruction fetch from 
main storage. 

NOTE: Significant throughput degradation can occur while processing with this 
switch set to the l-COUNTER REAL ADR position. 



STOP ON ADDRESS 

COMPARE 

MODELS 135, 145, 

AND 155-11 



ADDRESS COMPARE 



ANY 



ANY 
LOGICAL , 
ADR 
I COUNTER 

CTRL WORD* 
ADR 
CTRL WORD 
TRAP 




•DATA STOR 



*!/0 REAU 
ADR 

• I COUNTER 

DATA COMP 
TRAP 



o 



Data compare trap (Model 145) 

This facility is useful during hands-on debugging to determine what instruction is 
causing a particular storage byte location to be modified. 



1. Press STOP. 

2. Set the ADDRESS COMPARE switch to DATA COMPARE TRAP. 

3. Set the address of the storage byte location being modified in console 
switches CDEFGH. 

4. Set data switches A and B to the desired byte match value. 

5 . Set the ADDRESS COMPARE CONTROL toggle switch to STOP. 

6. Press START. 

When a store operation modifies the specified storage byte location to the value set 
in switches A and B, the ADR COMP MATCH indicator is turned on and the CPU 
enters a soft-stop state. 

To determine the address of the instruction that modified the storage byte, display 
the current PSW, and subtract the current instruction length code from the 
instruction address in the current PSW. 




o 



Note: 

The instruction found with this procedure may not have modified the data. An 

I/O data trap occurring during execution of this instruction could have modified 

the data. To determine which I/O data trap modified the data, log the address 

displayed in the A-Register Display roller switch indicators and call your service 

representative. 
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Aids provided by the Operator's Console 



STOP ON ADDRESS 

COMPARE 

MODELS 115 AND 125 



How to use 

Before this facility can be used the mode select display must be brought to the 
screen by pressing the MODE SELECT key. 

To select the storage ADDRESS COMPARE display shown below: 

1. Type in 'C beside MODE SPECIFICATION on the mode select display. 

2. Press ENTER. 



Error Indications 

If you make an error when typing in 
the code or hex characters: 

• The address compare display stays 
on the screen. 

• INVALID CHARACTER appears. 

• The cursor marks the location of the 
first error. 

The display remains on the screen 
as long as an entry error has not been 
corrected. When there is no error, 
the display disappears after ENTER 
is pressed. 



MAIN STORAGE ADDRESS COMPARE * 



P PROCESS 



COMPARE TYPE 



D DATA STORE 



I I/O DATA 



C INSTR.COUNT 



STORAGE ADDRESS 



000000- FFFFFF 



Three columns are displayed and an entry must be made under each column. 



I i 



S STOP: the machine stops when the address has been found. 

AC HON < y SYNC: a signal for the customer engineer is given when the address has been 
^ found. 

P PROCESS: address compare mode is turned off and normal processing continues. 

A ANY: the CPU will compare your search address (the address you type into 
column three) against all addresses used in the system. 

D DATA STORE: the CPU will compare your search address against only those 
storage addresses used to store data. 

Your search address will not be compared against addresses used in transferring 
data to or from I/O devices. 

I I/O DATA: the CPU will compare your search address against only those 
storage addresses used in transferring data to or from I/O devices. 

C INSTR COUNT: the CPU will compare your search address against only those 
STORAGE ADDRESS^ addresses used when fetching instructions. 

The real storage address at which the stop is to occur. 



COMPARE TYPE < 



%# 



^*u*r 
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o 



fl 



Press MODE SELECT 



The machine stops and the display 
disappears. 



Type in Cand press 
ENTER 



Type in S (or Y) 



Type in code for type 
of data to be compared 



Type in real storage 
address (6 hex digits) 



Press ENTER 



Processing continues until 
address is found. Then 
System stops. 



Press START 



Make a note of the data 
displayed on line 15 




YES 



Press MODE SELECT. 
Type in CP. 
Press ENTER. 



To resume processing 
press START 



Aids provided by the Operator's Console 

STOP ON ADDRESS 

COMPARE 

MODELS 115 AND 125 



Y is for CE use only. 



Codes are: 
A = ANY 

D = DATA STORE 
I = I/O DATA 
C = INSTR COUNT 



(See the description 
of the codes on the 
opposite page) 



Addresses outside the real address area cause 
| message INVALID ADDRESS to be displayed 



Address compare display is replaced but 
specifications entered are displayed on line 14 
of the new display 



• The last operating message stays on the 
screen. 

• MAN appears. 

• The addresses on lines 14 and 1 5 are the 
same. 




Stop on Address Compare mode is 
cancelled 



Fast Selection: You can type your specifications for address compare directly 
into the mode select picture. For example, you can type CSC005FAC, without 
commas of blanks to specify Compare with action Stop during instruction 
fetching with address 005FAC. 
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STOP ON ADDRESS 
COMPARE 
MODEL 158 

STOP ON A REAL ADDRESS 



COMPARE TYPE 

Note: If STOP is not selected 
a 'sync' pulse will be generated 
on true comparisons and the 
CPU will not stop. 



How to use 

Before this facility can be used the MANUAL frame must be brought to the screen 

by pressing the MODE SEL key. 

To stop on a real address S-SAR COMP SEL(REAL) must be used in conjunction 
with E-SAR COMP SEL(REAL). 

1. Select the STOP function ■ 5-STOP or type in S5 

2. Select the compare type (see below) 

3. Enter a real address at E-SAR COMP SEL(REAL). 

A stop will occur on any quadword boundary of a selected real address 

1-ANY: the CPU will compare the address set under E with all addresses used in the 
real addre ss area. When a true comparison is met the CPU will stop. 
2-STORE: causes the CPU to stop when a STORE operation is performed on the 
location at the address entered under E. 

3-FETCH: causes the CPU to stop when a FETCH operation is performed on the 
location at the address entered under E. 

__ 4-1/0: causes the CPU to stop when data is transferred either to or from the 
location at the address entered under E. 

The example below shows the appearance of the manual frame after selecting a 
stop on a FETCH operation on the location at real address 007FF8. 



O 



STOP ON A VIRTUAL 
ADDRESS AND DATA 
COMPARE TRAP 




A facility on the System/370 Model 158 allows a stop on a virtual address with a 
maximum of 6 conditions described in the table below. 



FUNCTION 


CPU ACTION 


USAGE 


G1 -STORE 
G2-IAR 


Stops processing after a store to the virtual address specified 
in ADR1. 

Stops processing after an instruction fetch to the virtual 
address specified in ADR1 . 


The cursor can be backed up under the digit to the left of the 
period and the base register entered in that position. The six 
digits to the right of the period are used to contain the dis- 
placement. The DATA fields and the ADR2 and ADR3 fields 
can be used to further define the stop conditions, giving a 
maximum of six conditions that must be satisfied before a 
stop occurs. The C to the left of the period in the data field 
signifies that the specified data will be compared. When the 
C is changed to a 1 , the specified bits are compared. 

Example: If the character to the left of the period is changed 
to a 1, and 1A is entered in the DATA field, a stop occurs 
whenever bits 3, 4, and 6 are on. Conversely, if the C is 
changed to a 0, a stop occurs whenever bits 3, 4, and 6 are 
off. 


H1-ADR1 
H2-DATA 


Specifies the first condition that must be met in order for 
a stop to occur. 

Specifies the data that must be found at the address in 
ADR1 for a stop to occur. If DATA is not pressed, the stop 
occurs whenever the location specified by ADR1 is 
addressed. 


H3-ADR2 
H4-DATA 


Specifies additional conditions that must be met if a stop 
is to occur. 


H5-ADR3 
H6-DATA 


Specifies additional conditions that must be met if a stop 
is to occur. 
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Press STOP 



Aids provided by the Operator's Console 

STOP ON ADDRESS 

COMPARE 

MODEL 158 



Press MODE SEL 



Type in S5 or press 
light pen to lozenge 
■ 5-STOP 



The manual frame will be displayed 



i If STOP is not selected, a sync pulse 
(only is generated on true comparison 
for use by the IBM CE 



Type in a code number 
or use the light pen, to 
specify the type of 
compare required 



Type in a six digit 
addresss in hexadecimal, 
or use the light pen at HEX 
INPUT on the display. 



Press ENTER or COPY 



Processing continues 
until address is found. 
Then System stops. 



Press START 




Yes 



Press CANCL 



To resume processing 
press START 



I Codes arej 
h-ANY 



I I see the description 
1 2-STOR E I J of the codes under 
J3-FETCH ?S COMPARE TYPE 
|4-l/0 I Ion the opposite Page. 



|The address will be displayed as 
\ it is entered at E-SAR COMP 
JSET (REAL) The address 
: specified must be within the 
i real address area 



\ Using Copy will cause the entire 
; manual frame to be printed on 
\ the 321 3 printer 



The word MAN will be 
| displayed at the lower right 
I corner of the display 



The manual frame is replaced 
by the program frame 
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CONSOLE DUMP 

OPERATION 

MODELS 115 AND 125 ONLY 



This operation provides a non-destructive readout and printout of any real storage 
area (up to 64K bytes at a time). The command can be executed at any time, and 
the (dumped) program can continue as soon as dumping is completed (no IPL or 
restart required). 
To select the storage dump display: 

1. Type D into the mode select display. 

2. Press ENTER. 

The display shown below appears on the screen. 



MAIN STORAGE DUMP 



Error Indications: 

PRINTER NOT READY appears 
if the line printer is not ready. 
STORAGE END appears if the 
start address is greater than the 
physical size. 

INVALID CHARACTER appears 
for any non-hex digits. 
INCOMPLETE ENTRY appears 
when necessary. 



ENTER START ADDRESS: 00 03 00 
END ADDRESS: ** 12 FF 



STORAGE END 



How to use 

1. Type in the start and end addresses. Remember that: 

• The low order halfword must be two zeros. 

• The end address must be within 64K bytes from the start address, and the 
low-order halfword must be FF. 

• If the dump required is more than 64K bytes, repeat the operation with 
a new start and end address. 

2. Press ENTER. 

• Dumping can be stopped at any time by pressing MODE SELECT, CANCEL, 
or START. If one of these keys is pressed, DUMP CANCELLED appears on 
the screen. 

• DUMP COMPLETE appears on the scrren when the selected dump range has 
been printed. 

• STORAGE END appears on the screen when the upper boundary of storage 
has been reached. 

The flowchart shown on the opposite page shows the procedure for using this 
command. 






When to use 

This is a useful aid to use when large areas of real storage must be recorded for 
later analysis. It can also be used instead of the ALTER/DISPLAY feature to 
record low address storage before executing the stand-alone dump program. 



c 
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Aids provided by the Operator's Console 



Press MODE SELECT. 
Type in D. 
Press ENTER. 






CONSOLE DUMP 

OPERATION 

MODELS 115 AND 125 ONLY 



Ready the 
Line printer 



Enter the starting and 
ending addresses in hex 



Press ENTER 



The end address cannot be 
more than 64K from the start 
address 



Dumping begins 



Press MODE SELECT 
CANCEL, or START. 




DUMP CANCELED 
is displayed 



Press CANCEL 



The dump display disappear. 



To resume processing 
Press START 



Processing continues 



NOTE: If a log or retry operation takes place at the same time as a 
dump request, PRESS CANCEL appears on the screen. After pressing 
CANCEL, the message LOG IN PROGRESS appears in the machine 
status area. You can repeat dumping as soon as the log message 
disappears. 



D 10 F 



o 
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STORE STATUS 
(ALL MODELS) 



This function enables certain control information to be stored and preserved for 
analysis by the IBM CE. 

Models 135, 145 and 155-11 

1. Press the console printer keyboard ALTER/DISPLAY key. 

2. Type in ST. 

The information saved is identical to that listed below for the Model 125 



O-OPERATOR FUNCTIONS 
1-PSW RESTART(PRGM) 
2-RESTART(PRGM) 
3-SYSTEM RESET 
4-LOAD 

5-STORE STATUS 
6-SYS REST (CLEAR) 
7-LOAD(CLEAR) 



I- 


LOAD UA 
000 


W-SWAP 
SAR 13 


X 


-EXECUTE 
OPERATOR FUNCTION 



Models 115 and 125 

There is no display for STORE STATUS. 
To store the status: 

1. Type S into the mode select display. 

2. Press ENTER. 

The following information is stored. 



CPU Timer 
Clock Comparator 
The current PSW 
Floating-Point Registers 
Control Registers 
General Registers. 



> < 



After ENTER has been pressed: 

• The mode select display remains on the screen and STATUS STORED appears. 

• The system goes into the stopped state . 

• The S has disappeared from the mode specification field, so this field is free 
and another operation can be specified. 

Note: This function must not be used on a Model 115 or 125 that does not support 
MCE (Machine Check Handling). 

'Model 158 

1. Press MODE SEL to obtain the manual frame. 
' 2. Type in 03 or hold light pen against ■ 3-SYSTEM RESET. 

3. Type in X or press light pen to lozenge ■ OPERATOR FUNCTION. 

4. Type in 05 or press light pen to lozenge ■ 5-STORE STATUS. 

5. Type in X or use light pen at ■ OPERATOR FUNCTION. 

A new function may now be selected. 

When to use 

This function should be used before executing the stand-alone dump program. 
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Models 135, 145 and 155-11 

Real storage can be cleared to zeros by the following procedure: 

1. Press and hold in ENABLE SYSTEM CLEAR. 

2. Press SYSTEM RESET or LOAD. 

3. Re-IPL to continue processing new job. 
Note: Control storage is unaffected. 



Aids provided by the Operator's Console 

CLEAR REAL STORAGE 
(ALL MODELS) 



o 



Models 115 and 125 

1. Press the MODE SELECT key. 

2. Type RC into the mode select display. 

Note: AtlPL time one of the LOAD parameters is NORMAL or CLEAR 

Model 158 

Two methods are available on the Model 158 to clear real, or main storage. 

1 . System Reset (Clear): In addition to performing the reset function, this causes 
main storage and the storage-protect arrays to be validated (cleared to zeros with 
good parity). 

• Press MODE SEL to obtain the manual frame. 

• Type in 06 or hold light pen against ■ 6-SYS RESET (CLEAR). 

• Type in X or hold light pen against ■ OPERATOR FUNCTION. 

2. Load (Clear): In addition to performing the load function, this causes the IPL 
function to be preceded by an initial program reset, and clears main storage and 
the storage-protect arrays. 

• Press MODE SEL to obtain the manual frame 

• Enter a load unit address 

• Type in 07 or hold the light pen against ■ 7-LOAD (CLEAR). 

• Type in X or use light pen at ■ OPERATOR FUNCTION. 



When to use 

This facility should be used with caution. An example of its use is to reset the 
hardware after a machine check is caused by a parity error in real storage. It must 
be used after you have gathered all the information from the system. 
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SAVE USAGE COUNTERS 



There is no display for SAVE USAGE COUNTERS. 
To select the save usage counters operation: 

1. Type U into the mode select display. 

2. Press ENTER. 

When to use 

This operation saves the usage counters of all disk drives. The operation should 
always be performed before you turn the power off so that the information can be 
used by the CE for maintenance. The message 'counter saved' appears for each 
counter that is recorded. 






c 
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Other Aids 

JOB CONTROL 
COMMANDS AND 
STATEMENTS 



The following commands and statements are not primarily designed as 
serviceability aids, but enable useful information to be obtained from the system 
during program execution. 

For example, it is useful to place the LISTIO statement and command in job 
streams where device assignments are suspected of causing errors. The LOG 
command enables you to record job control statements and commands issued 
during a job, and the MAP command enables you to check partition allocation. 
These three commands, LISTIO, LOG, and MAP can be used therefore as a "job 
stream trace," as shown in the example opposite. 

In certain cases of system malfunctions, this information, used in conjunction with 
dumps and trace routine output, will help during offline debugging. 



LISTIO or// LISTIO 

The LISTIO command or statement (List I/O Assignment) causes the system to 
print a listing of I/O assignments. The listing appears on SYSLOG (command) or 
SYSLST (statement). If SYSLST is not assigned, the LISTIO statement is ignored. 



Statement Format 



II LISTIO 



SYS 

PROG 

BG 

F4 

F3 

F2 

F1 

ALL 

SYSxxx 

UNITS 

DOWN 

UA 

X'cuu' 



— (output on SYSLST) 



Command Format 



LISTIO 



SYS 

PROG 

BG 

F4 

F3 

F2 

F1 

ALL 

SYSxxx 

UNITS 

DOWN 

UA 

X'cuu' 



— (output on SYSLOG) 



The table following the example opposite explains the meaning of the LISTIO 
options. 
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Other Aids 

JOB CONTROL 

COMMANDS AND 

STATEMENTS 



o 





An example of a "job stream trace" using the LOG, MAP, LISTIO and PAUSE 
commands and statements. 
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JOB CONTROL 
COMMANDS AND 
STATEMENTS 



Options for LISTIO 



Options 


Meaning 


SYS 


Lists the physical units assigned to all system logical units. (See note.) 


PROG 


Lists the physical units assigned to all background programmer logical units. (See note.) 


BG 


Lists the physical units assigned to all background logical units. 


F4 


Lists the physical units assigned to all foreground-one logical units. 


F3 


Lists the physical units assigned to all foreground-two logical units. 


F2 


Lists the physical units assigned to all foreground-three logical units. 


F1 


Lists the physical units assigned to all foreground-four logical units. 


ALL 


Lists the physical units assigned to all logical units. 


SYSxxx 


Lists the physical units assigned to the logical unit specified. The assignment is given for the partition from 
which the command is given. (See note.) 


UNITS 


Lists the logical units assigned to all physical units. (See note.) 


DOWN 


Lists all physical units specified as inoperative. (See note.) 


UA 


Lists all physical units not currently assigned to a logical unit. 


X'cuu' 


Lists the logical units assigned to the physical unit specified. 



c 



Note: Physical units are listed with current device specification for magnetic tape units. Logical units are listed with ownership 
(background, or any foreground), when applicable. If a unit has a standard assignment in one mode and a temporary assignment 
in another mode, the CMNT column identifies the type of assignment for each indicated mode. All channel unit numbers are 
represented in hexadecimal. 

LOG 

The LOG job control command causes the system to log, on SYSLOG, columns 
1-72 of all Job Control commands and statements occurring in the batched-job 
partition in which the LOG is issued. The AR LOG affects all the partitions. The 
LOG function is effective until a NOLOG command for the partition involved is 
sensed. 

The format for the LOG job control command via attention routine is as follows: 
LOG blank 

The operand field is ignored by the system. 

NOLOG 

The NOLOG command (suppress logging) terminates the listing, on SYSLOG, of 
Job Control commands and statements (except JOB, PAUSE, STOP, ALLOC, 
MAP, HOLD, RELSE, UNA, DVCDN, DVCUP, *, and /&) that occur in the 
batched-job partition in which the NOLOG is issued. The NOLOG function is 
effective until a LOG command for the partition involved is sensed. 

The format for the NOLOG job control command via attention routine is as 
follows: 

NOLOG blank 

The operand field is ignored by the system. 
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MAP command 

The MAP command produces on SYSLOG a map of virtual storage areas allocated 
to programs. 

An example of the output produced on the console printer is shown below: 



Other Aids 

JOB CONTROL 

COMMANDS AND 

STATEMENTS 





F2 


map 














• 


F2 

F2 


AREA 


K- 


-REAL 


UPPER LIMIT 


K-VIRT 


UPPER LIMIT 


NAME 




F2 


SP 




92K 


94207 




262144 




• 


12 


BG 


V5A 


30K 


124927 


292K 


561151 


KENSLOOP 


F2 


F4 


14 


10K 


135167 


80K 


643071 






F2 


F3 


U3D 


10K 


145407 


80K 


724991 




• 


F2 


F2 


V2A 


14K 


159743 


100K 


827391 


NO NAME 


F2 


Fl 


11 


82K 


243711 


120K 


950271 






F2 


SVA 








96K 


1048575 




• 


F2 


VIS 








68K 


1048575 




F2 


PP 




18K 


262143 






£kS%ki 






SP = Supervisor, V = Virtual, PP = Main Page Pool, 1 = Inactive, SVA = Shared Virtual Area, R = Real, 
A = Active, D=Deactivated 

1 , 2, 3, 4, 5 = Partition Priority (1 = highest priority), VIS = Amount of SVA reserved by GETVIS 
parameter of the VSTAB system generation macro 


K-REAL 


gives the number of bytes allocated to the real partition or the number of bytes of the main page pool. The size 
is given in multiples of 2K. 


UPPER LIMIT 


shows the highest storage addresses in decimal of the respective real partition, of the supervisor, and of the main 
page pool. 


K-VI RT 


specifies the number of bytes allocated to the respective virtual partition. The size is given in multiples of 2K. 
This field is blank for the supervisor and for the main page pool. 


UPPER LIMIT 


contains the highest storage address in decimal of the respective virtual partition. For the supervisor, this field 
specifies the start address of the virtual address area. This field is blank for the main page pool. 


NAME 


contains the name of the job which is currently executing in the corresponding partition. This field is blank for 
the supervisor, SVA, VIS, and for the main page pool. When the listing shows NO NAME for the background, 
or when the name field is blank for a foreground partition, no program is being executed in that area. However, 
the name field for any partition contains NO NAME when no job control statement or command was entered, 
but the program is active. 



Note: If a program issues an SVC55, some page frames in the main page pool (PP) will also belong to that program. Therefore to calculate 

the total area in real storage occupied by that program, the MAP command should be issued before running it. The difference between 

the number of K in the PP before running the program, and the number of K during the execution of the program is the amount of K 

seized by the SVCS5. 

This also applies when PDAID output mode is an alternate area or the SDAID is initiated. 

In this case, the area occupied by the PDAID or SDAID is printed during their initialization. 

Note: The output does not indicate storage temporarily added to the page pool as a result of using the SIZE parameter of the 
EXEC statement. 
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OPTION 

The OPTION statement specifies one or more of the Job Control options. The 
format of the OPTION statement is: 

JCS Format 

//OPTION option 1 (,option2,...) 

The options that can appear in the operand field follow. Selected options can be 
in any order. Options are reset to the standards established at system generation 
time upon encountering a JOB or a /& statement. 

DUMP Causes a dump of the registers and main storage to be output on 
SYSLST, if assigned, in the case of an abnormal program end. (See 
A -2 in this section for a full description.) 

NODUMP Suppresses the DUMP option, if the latter was specified in the STDJC 
macro during system generation. 

LOG Causes the listing of columns 1-80 of all control statements on 

SYSLST. Control statements are not listed until a LOG option is 
encountered. Once a LOG option statement is read, logging continues 
from job-step to job-step until NO LOG option is encountered or until 
either the JOB or /& control statement is encountered. 

NO LOG Suppresses the listing of all valid control statements on SYSLST until 
a LOG option is encountered. If SYSLST is assigned, invalid 
statements and commands are listed. 

LIST Causes language translators to write the source module listing on 

SYSLST. In addition, it causes the Assembler to write the hexadecimal 
object module listing and causes the Assembler and the FORTRAN 
compiler to write a summary of all errors in the source program. All 
are written on SYSLST. 



"<:. 



NOLIST Suppresses the LIST option. 



PAUSE 

The PAUSE command causes a pause at the end of the current job step. The 
PAUSE Job Control statement causes a pause immediately after processing this 
statement. At the time, SYSLOG is unlocked for message input. END (on the 
Models 135 and 145) or ENTER (on the Model 125) causes processing to continue. 
The PAUSE statement or command always appear on SYSLOG. If a 3210 or 3215 
or video console display unit is not available, the PAUSE statement or command 
is ignored. 



c 
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x Other Aids 

This is an area of real storage, starting at byte address 000000, and permanently LOW ADD R ESS 

reserved for use by the supervisor. STO R AG E 

For the purpose of program debugging, low address storage extends up to byte 
address 160 decimal (X'BF') 

Displaying low address storage 

Low address storage will always be dumped during the execution of: 

• A stand-alone dump; see A-2 in this section. 

• A system dump; see A-2 in this section. 

• A transient dump (bytes 0-144 hex); see A-4 in this section. 

Low address storage can also be dumped by means of DUMP or DSPLY operator 
commands (see A-l in this section), or the ALTER/DISPLAY feature on the 
console printer or display unit keyboard (see D-l in this section). 

When to display 

• Low address storage must be dumped by using the ALTER/DISPLAY 
console printer feature whenever a hard wait is recognized. 

• When a system malfunction is recognized in one of the programs in a 
multiprogramming or teleprocessing environment, low address storage must 
be dumped by using the DUMP or DSPLY commands in order to avoid total 
system collapse. 

Flowchart D-l-F in this section shows how to dump low address storage by using the 
ALTER/DISPLAY feature on the console printer. Flowcharts in Section 3 indicate 
when to dump low address storage. 

CAW (Channel Address Word) 

The CAW specifies the storage protection key and the address of the first channel 
command word associated with the START I/O instruction. The CAW is found at 
hex location 48. 




KEY 


0000 


Channel Command Word Address 



31 



Note: After the execution of any dump program, the information in the CA W is 
unreliable. In this case, the start address of the CCW is found in the command 
control block (CCB). 

Locating CCBs is described in Section 4. 
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CSW (Channel Status Word) 

The CSW informs the program of the status of an I/O device or the conditions 
under which an I/O operation has been terminated. The CSW is formed, or parts 
of it are replaced, during I/O interruptions and during execution of I/O 
instructions. The CSW is placed in low address storage at location hex 40. It is 
available to the program at this location until the next I/O interruption occurs or 
until another I/O instruction generates a new CSW, whichever occurs first. When 
the CSW is stored as a result of a START I/O instruction, the I/O device is 
identified by the I/O address in the old PSW. The information placed in the CSW 
by an I/O instruction pertains to the device addressed by the instruction. 

The CSW format is shown below. 



i 



Key 





L 


J 
CC 

i 


Channel Command Address 


Unit Status 


Channel Status 


Count )] 





4 






8 


32 


40 


48 63 



Bits 0- 3 


Protection key used in the last operation 


Bit 5 


Reserved 


Bits 6- 7 


Deferred condition code 


Bits 8-31 


Address plus 8 of the last CCW used 


Bits 32-39 


contain the unit status byte: 




Bit 32 attention 




Bit 33 status modifier 




Bit 34 — control unit end 




Bit 35 — busy 




Bit 36 channel end 




Bit 37 — device end 




Bit 38 unit check 




Bit 39 — unit exception 


Bits 40-47 


contain the channel status byte: 




Bit 40 — program-controlled interruption 




Bit 41 incorrect length 




Bit 42 program check 




Bit 43 — protection check 




Bit 44 — channel data check 




Bit 45 — channel control check 




Bit 46 — interface control check 




Bit 47 chaining check 


Bits 48-63 


Residual count of the last CCW used 






Note: After the execution of any dump program, the information in the CSW is 
unreliable. In this case, CSW information is found in the command control block 
(CCB). 

Locating CCBs is described in Section 4. 
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PSW (Program Status Word) 

The PSW contains information required for the program execution. By storing the 
PSW, the control program can preserve the status of the CPU for later inspection. 
By loading a new PSW or part of a PSW, the status of the CPU can be changed. 

The format of old and new PSWs is the same as that of the current PSW, shown 
below : 



LOW ADDRESS 
STORAGE 



u 


R 


U 


U 





T 


1 


E 


Protection 
key 


1 


M 


W 


P 


U 


U 


C 


C 


Program 
mask 


Unassigned 


Reserved 


^N Instruction Vi 
)) address JJ 



















8 










16 








20 


24 


33 


40 63 



U indicates the bit is unassigned. 

indicates the bit is set to zero. 

1 indicates the bit is set to one. 



PROGRAM EVENT RECORDING MASK 
(Bit 1 ). 



TRANSLATION MODE (Bit 5). 



I/O MASK (Bit 6). 



EXTERNAL MASK (Bit 7). 



PROTECTION KEY (bits 8-11 ). 



EXTENDED CONTROL MODE INDICATOR 
(Bit 12). 



MACHINE CHECK MASK (Bit 13). 



WAIT STATE (Bit 14). 



PROBLEM STATE (Bit 15). 



CONDITION CODE (bits 18-19). 



PROGRAM MASK (Bits 20-23) 



INSTRUCTION ADDRESS (Bits 40-63). 



If ON, permits interruptions subject to the program-event control bits in control 
register 9. 



If ON, invokes the dynamic address translation (DAT) services. 



It ON, enables I/O interruptions subject to the channel mask bits in control 
register 2. 



If ON, enables external interruptions subject to the corresponding external 
sub-class mask bits in control register 0. 



Is compared with a storage key whenever a result is stored, or information is 
fetched from a protected location. 



If ON, indicates that the supervisor operates in Extended Control (EC) model. 



If ON, enables machine check interruptions resulting from system damage or 
instruction-processing damage; other machine check interruptions are enabled 
subject to the sub-class mask bits in control register 1 4. 



If ON, indicates that the CPU is in the Wait State. 



If ON, indicates that the CPU is in the Problem State; if OFF, the CPU is in the 
Supervisor State. 



Is set as the result of the execution of certain instructions. 



comprises: 

Fixed-Point Overflow Mask 

Decimal Overflow Mask 

Exponent Underflow Mask 

Significance Mask. 

A Mask bit ON enables an interruption when the specified exception occurs. 

The Significance Mask bit also determines the manner in which floating-point 

addition and subtraction are completed. 



For all PSWs, the address is that of the next logical instruction. In addition, for 
the new PSWs the address points to the routine that handles the particular 
interrupt, and for the old PSWs it contains the return address in the 
calling routine. 
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LOW ADDRESS 
STORAGE 



Displacement 
in hexadecimal 


Description (all numbers referenced are in hexadecimal). 


0-7 


The field is used for the following two functions: 

Restart New PSW: The new PSW is fetched from locations 0-7 during the restart operation. 

IPL PSW: The first eight bytes read during the IPL initial read operation are stored at locations 0-7. The 

contents of these locations are used as the new PSW at the completion of the IPL operation. These locations 

may also be used for temporary storage at the initiation of the IPL operation. 


8-F 


The field is used for the following two functions: 

Restart Old PSW: The current PSW is stored as the old PSW at locations 8-F during the restart operation. 
IPL CCW1 : Bytes 8-F read during the IPL initial read operation are stored at locations 8-F. The contents of 
these locations are ordinarily used as the second CCW in an IPL CCW chain after completion of the IPL initial 
read operation. 


10-17 


IPL CCW2: Bytes 10-17 read during the IPL initial read operation are stored at locations 10-17. The contents 
of these locations may be used as the third CCW of an IPL CCW chain after completion of the IPL initial read 
operation. After IPL bytes 14-17 contain the address of the background partition communication region. 
Thereafter they contain the address of the communication region for the active partition. (Communication 
regions are described in Section 4). 


18-3F 


Interruption Old PSWs: The current PSW is stored as the old PSW at locations 18-1 F, 20-27, 28-2F, 30-37, and 
38-3F during the external, supervisor-call, program, machine-check, and input/output interruptions, 
respectively. 


40-47 


CSW : The channel status word (CSW) is stored at locations 40-47 during an I/O interruption. It, or portions 
thereof, may be stored during the execution of START I/O, START I/O FAST RELEASE, TEST I/O, HALT 
I/O, or HALT DEVICE, in which case condition code 1 is set. 


48-4B 


CAW: The channel address word (CAW) is fetched from locations 48-4B during the execution of START I/O 
and START I/O FAST RELEASE. 


4C-4F 


Save area for job duration measurement when the interval timer location is being used by the supervisor 
IT option routines. 


50-53 


Interval Timer: Locations 50-53 contain the interval timer. The timer is updated whenever the CPU is in the 
operation state. Depending on the resolution of the timer, the low-order locations may not be updated. 


54-57 


Contain the time of day. 


58-7 F 


Interruption New PSWs: The new PSW is fetched from locations 58-5F, 60-67, 68-6F, 70-77, and 78-7F 
during the external, supervisor-call, program, machine-check, and input/output interruptions, respectively. 


80-83 


The address of the system communication region, described in Section 4. 


84-87 


External-interrupt Code: During an external interruption in the EC mode, the interruption code is stored at 
locations 86-87 and zeros are stored at locations 84-85. 


88-8B 


SVC-lnterrupt Code: During a supervisor-call interruption in the EC mode, the instruction-length code is stored 
in bit positions 5 and 6 of location 89, and the interruption code is stored at locations 8A-8B. Zeros are stored 
at location 88 and in the remaining bit positions of 89. 


8C-8F 


Program Check Interrupt Code: During a program interruption in EC mode the instruction-length code is 
stored in bit positions 5 and 6 of location 8D, and the interruption code is stored at locations 8E-8F. Zeros 
are stored at location 8Cand in the remaining bit positions of 8D. 


90-93 


Translation-Exception Address: During a program interruption due to a segment-translation exception or a 
page-translation exception, the translation-exception address is stored at locations 91 -93, and zeros are stored 
at location 90. 


94-95 


Monitor-Class Code: During a program interruption due to a monitor event, the monitor-class number is 
stored at location 95, and zeros are stored at 94. This field can be stored in either the BC or EC mode. 


96-97 


PER-lnterrupt Code: During a program interruption due to a program event, the program-event-recording 
(PER) code is stored at location 96, and zeros are stored at 97. This field can be stored only when the 
instruction causing the PER condition was executed under the control of a PSW specifying the EC mode. 


98-9 B 


PER Address: During a program interruption due to a program event, the program-event-recording (PER) 
address is stored at locations 99-9 B, and zeros are stored at location 98. 

This field can be stored only when the instruction causing the PER condition was executed under the control 
of a PSW specifying the EC mode. 


9C-9F 


Monitor Code: During a program interruption due to a monitor event, the monitor code is stored at locations 

9D-9F, and zeros are stored at location 9C. 

This field can be stored in either the BC or EC mode. 



Table E-2 Format and contents of low address storage. 
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Other Aids 

LOW ADDRESS 
STORAGE 



These bytes may contain: 

• IPL error codes during errors at IPL, or 

• coded messages if an error occurs during normal 
program execution, and SYSLOG and SYSLST 
are both inoperable, (see E-3 in this section). 



After IPL, these four bytes 
contain the address of the BG 
communications region. There- 
after, they contain the address of the 
communications region for the 
active partition. J* 



Key 


0000 


Channel Command Address 


Unit Status 


Channel Status 


Count 



FORMAT OF EC MODE PSW 


























URUUOT 


1 



E 


Protection 
key 


1 MW P U U CC 


Program 
mask 


Unassigned 


Reserved 


Instruction address 



28 Program old PSW 




4C job duration 



IPLCCW2 



30 Machine check old PSW 



50 Interval timer 54 Time of day 



70 Machine check new PSW 



svc 8C Pr °9 r am check q _ Translation g4 Monitor PER g8 pFR , riHrp< ._ or Monitor code 

interrupt code | gu interrupt code 1 90 exception \^ class code PfcR address aL Mormor ^^ 



18 External old PSW 



38 Input/output old PSW 



58 External new PSW 



78 Input/output new PSW 



000000000000 ILC 



PROGRAM-INTERRUPTION 
CODE 



The format and contents of low address storage 



\ 




00000000 



MONITOR CODE 



00000000 



PER ADDRESS 



00000000 MONITOR-CLASS 



PER CODE 



00000000 



00000000 TRANSLATION-EXCEPTION ADDRESS 



GR 0-F 

FP REG 

CR 0-F 

C0MREG 



000000 
000020 
000040 
000060 
0O~OO8O' 
0000A0 

ooooco 

0004A0 



J, 0004C0 
Cf\ (ApOOtEO 

(Sr ooo5oo 

CCV O00520J 
00 ^54 OJ 
000560 
000580 



DEBUGEX3 

000000 IB 
00000000 

oooooooo 

004000FF 
0000FFFF 
BG AODR IS 0004A0 



12/06/73 

00040910 00000049 00000002 00C0002E 00000000 

00000000 00000000 4004007A 0004107A D7C8C1E2 

oooooooo cooooooo oooooooo oooooooo oooooooo 

0O0OE640 FFFFFFFF FFFFFFFF 00000000 O00C0O00 

oooooooo oooooooo OOOOOOOO oooooooo oooooooo 



21.01.45 



PAGE 



oooooooo oooooooo 

A00406EE 000422A0 
OOOOOOOO OOOOOOOO 
OOOOOOOO OOOOOOOO 
C2000000 00000200 



fOOOOOOOO 
r070D0000 



oooooooq/ooc ooooo 

000085OE 



/^f*£/«t*»C 



J*cA *4/ />SW 



Q000E768 08000000 



04OCO0O0 00000902 




00000BCC 

00000080 

oooooooo 



0000E758 
O0GCO0O0 
00020007 
20O0O060 



OOOOOOOO OOOOOOOO 
OOOOOOOO 
FBCC1900 
04080000 
12042003 
OOOOOOuO 




^ ae ^^n^ t 



oooooooo 

0000A50C 

oojjgbooo 

0000B2C0 



OOOO gHAQ 

oooooooo 

045661E8 
0000013A 
00020000 
00000100 



07102000 00040084 
07OC2000 000009GC 
O4OCO00C 00000C14 
040C0000 00000B10 

oooo oono oooooicc 
oooo5oqeJU)ooooooo 



0000000 
F1F261F0 
00060FFF 
41044296 

46 300000 
OOOOOOOO 
r00006140 
00017000 
60800800 



— SAME — 
F661F7F3 
0004232F 
42974389 
3DCC3E4C 
04A010EO 
00002ECA 
05005DE6 
000008FC 



70007000 
C004232F 
3FC03F06 
3EBC0010 
00000588 
080407CO 
0032002C 
00009260 



oooo( Zn&£u6*C44t 



Ej k>000.0( 



Lot* /tcWVM 

S&tubVL K'oo'-x&f' 



•••••»•• 



•••••••• 






0000( 



3f0C , A e r r r ^ 

00000010 00003090 "' 

C0C00340 40404040 

00Q04134 00C026C4 

00050000 0000700C 

00005F78 00006068 



000 C4C5C2E4 %/0 beOhCCj^ 

E03 38AOCEDO 0C2E40FD 

4F0 00003CD4 00C0003C 

00007118 00003864 38D45A30 

40404000 40404040 40404000 ..... 

00004388 00005854 000082E8 ../ ., 

OOOOOOOO 00008299 00006088 

000060CO 00100010 000074BO -.... 



DEBUGEX3 

L 

20673340.. .M.... 
M. # 



{£xS?tcr\ 



An example of a system dump printout, reduced in size, showing the address storage 
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WAIT STATE 
MESSAGES 



Bytes - 3 of low address storage are used to store and record coded messages 
when a system malfunction occurs during IPL. Other occasions when coded 
messages are stored in these bytes are described below under "Wait states during 
problem program execution." 

Whenever a wait state occurs, it is imperative that these low address storage bytes 
are dumped by using the console printer ALTER/DISPLAY feature, described in 
D-l of this section. 

The table below lists all the coded wait state messages: 



v.-.y 



BYTEO 


BYTE 1 


BYTE 2 


BYTE 3 


EXPLANATION 


MCH/CCH/IPL Hard Wait Codes placed in low address storage 


x'cr 


X'E2'(2) 


A, I, SO) 


Not used 


Irrecoverable machine check. 


X'C2' 


X'E2'(2) 


Not used 


Not used 


Irrecoverable channel failure during RMS fetch. 


X'C3' 


X'E2'(2) 


A,I,S(1) 


Not used 


Channel failure on SYSLOG when RMS message scheduled. 


X'C4' 


X'E2'(2) 


A, I, SO) 


Not used 


No ECSW stored 


X'C5' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure: ERPBs exhausted. 


X'C6' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure; two channels damaged or a damaged channel situation occurred while RMS 
was executing an I/O operation. 


X'C7' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure; system reset was presented by a channel. 


X'C8' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure; system codes in ECSW are invalid. 


X'C9' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure; channel address invalid. 


X'D1 ' 


X'E2'(2) 


A, I, SO) 


Not used 


Irrecoverable channel failure on SYSVIS. 


X'07' 


X'E6' Channel 


Unit or 


IPL I/O error or equipment malfunction; condition code 2 during STIDC instruction. 








X'OO' 


Channel and unit indicate whether device in error is SYSRES or communication device. 
When byte 3 = X'OO', byte 2 indicates the channel for which STIDC instruction was 
issued. Re-IPL system. 


SDAID Hard Wait Code 


X'6V 


X'E6'(3) 


Channel 


Unit 


Another device is running in burst mode on same channel as SDAID output device. 
Re-IPL system. 


SDAID Soft Wait Code 


X'62' 


X'C5' 


Not used 


Not used 


SDAID output device became unready, Make printer ready and press the EXTERNAL 
INTERRUPT key. 


X'OO' 


X'OO' (3) 


X'OO' 


X'OO' 


SDAID Stop on Event. Press EXTERNAL INTERRUPT key to 
continue operations. 


The folic 


wing Hard Wait Codes are placed in general register 1 1 X'B' as well as in low address storage. 


X'OO' 


X'OO' 


X'OF' 


X'FF' 


Program Check in Supervisor. 


X'OO' 


X'OO' 


X'OF' 


X'FE' 


I/O error during fetch from System CIL. 


X'OO' 


X'OO' 


X'OF' 


X'FD' 


•Channel Failure if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FC 


Machine Check if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FB' 


Page Fault in Supervisor routine with identifier RID X'OO'. 


X'OO' 


X'OO' 


X'OF' 


X'FA' 


Translation Specification Exception 


X'OO' 


X'OO' 


X'OF' 


X'F9' 


Error on Paging I/O. 


X'OO' 


X'OO' 


X'OF' 


X'F8' 


CRT phase not found. 


X'OO' 


X'OO' 


X'OF' 


X'F7' 


No copy blocks available for BTAM appendage I/O request. 


X'OO' 


X'OO' 


X'OF' 


X'F6' 


$MAINDR canceled during system CIL update. 

If this occurs, the system CIL is only partially updated and must be restored before use. 
This hard wait condition can also occur if the FETCH QUEUE BIT (FCHQ) is set in the 
linkage control byte in the partition communication region owned by the 
terminating partition. 


Device E 


rror Recovery Soft Wait Codes placed in low address storage. 


X'08' to 


X'CTor 


Channel 


Unit 


Error recovery messages. Refer to OP messages in DOS/VS Messages. 



Notes: 1. A (X'CV) = SYSREC recording unsuccessful. 
I (X'C9') = SYSREC recording incomplete. 
S (X'E2') = SYSREC recording successful. 

2. S(X'E2') - Run SERE P. 

3. SDAID wait states are identified by X'EEEE' 
in the address part of the wait PSW. 

Table E-3 Wait State codes 
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Wait states during IPL 

If the system enters the wait state during an IPL procedure and no message is 
printed on SYSLOG, the operator should record at least the first five bytes of low 
address storage. The IPL error message number and action code are displayed in 
hex in these bytes. For example: 

Message Oil 1 A appears in low address storage bytes 0-4 as 

F0C9F1F1C1 

The operator should look up this message in DOS '/VS Messages and perform the 
indicated action, except for the messages noted below. 

IPL error messages 

If there is an equipment malfunction during IPL, or the IPL cannot be loaded, an 
IPL error message is placed in bytes 0-3. In this state all interrupts are disabled, 
and you must repeat IPL after dumping low address storage, as shown in 
flowchart D-l-F in this section. 



Other Aids 

WAIT STATE 
MESSAGES 



ByteO 


Byte 1 


Byte 2 


Byte 3 


Meanings: 


X'07' 


X'E6' 


Channel 


Unit or 
X'OO' 


IPL input/output error: 

• I/O error on SYSRES 

• I/O error on communication device (see notes 1 and message X'F0C9F0F1' 
below) 

• Equipment malfunction during the STORE CHANNEL ID instruction 
(see note 3) 

• Supervisor entry not found. 


X'FO' 


X'C9' 


X'FO' 


X'FO' 


This code indicates that less than 1 6K of real storage is left for problem 
programs. Check that the correct disk volume is mounted on the device 
assigned to SYSRES and re-IPL. If the error recurs, the system programmer 
must check the allocations of real partitions specified in the supervisor to 
be used, and check that at least 16K of real storage is available for execu- 
tion of problem programs running in virtual mode. 


X'FO' 


X'C9' 


X'FO' 


X'FV 


If a card reader has been assigned to SYSRDR during system generation 
and is to be the IPL communication device, press the INTERRUPT key. 

If a card reader has not been assigned to SYSRDR during system generation 
and yet it is to be the IPL communication device, simply READY the 
reader. 


X'FO' 


X'C9' 


X'FO' 


X'F2' 


This code means that the supervisor requested can not be found. 
Check that the correct disk volume is mounted on the device assigned to 
SYSRES. If it is correct, re-IPL and specify a different supervisor when 
message 0I03A is issued and press the END/ENTER key, or press END/ 
ENTER key only, to load the standard supervisor. (If possible contact 
the system programmer and check which supervisor to use.) 


X'FO' 


X'C9' 


X'FV- 
X'F2' 


X'FO'- 
X'F8' 


Refer to messages 01 100A - 0128A in DOS/VS Messages in the 
DOSA/S Messages manual 




Note I: When the IPL procedure reaches the normal IPL wait state, and the IPL 
communication device is to be SYSLOG, press the REQUEST key on 
the console printer keyboard. 

Note 2: When byte = X'OO', byte 2 indicates the channel for which the STIDC 
instruction was issued. 



o 
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WAIT STATE 
MESSAGES 



Wait states during program execution 

Three conditions will place a coded message in low address storage during program 
execution: 

• I/O device error 

• Hardware failures 

• Unrecoverable I/O error during FETCH. 

1 . I/O device error messages. 

Device Error Recovery Messages. 

The example below shows the information that is placed in low address storage 

bytes hex 0-3 when a wait state is caused by an I/O device error, and both 

SYSLOG and SYSLST are inoperative, or SYSLOG is not assigned. 

An example of a coded device error recovery message as it is stored in the low 

address storage is shown below: 

0P08A interv'reqsyslst=ooe 

An example of a device error recovery message is shown below: 




Refer to OP messages in DOS/VS Messages, 



f " 1 








ByteO 


Byte 1 


Byte 2 


Byte 3 


X'08' to 
XW 


Action 
indicator 
'C1 ' - 'C4' 


Channel 


Unit 






If this condition occurs, the operator must dump, or display and note, bytes 0-3 
of low address storage, and inspect the contents of byte 0. This byte contains a 
hex number that corresponds to an OP message listed in DOS/VS Messages. 

Before proceeding with system operation, the operator will have to decide whether 
to continue system operations with the program currently running or to CANCEL 
all jobs and repeat IPL. This decision depends on system commitments and the 
importance of other programs that are running. 

To continue operations, the operator must first inspect the contents of byte 1 
for the presence of a hex CI or C4. The flowchart opposite shows what further 
actions can be taken under these conditions, and a flowchart in Section 3 indicates 
to operators when this procedure may be required. 



^L^i^^r 
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From Chart 03 
Section 3. 



Other Aids 

WAIT STATE 
MESSAGES 



o 



Byte 1 contains X'CV 



Byte 1 contains X'C4' 



Inspect bytes 2 and 3 
Byte 2 indicates the channel, 
byte 3 indicates the unit. 






Insert X'OV (RETRY) 
in byte 4, and press the 
INTERRUPT key 




Yes 



Either; 

Perform any manual recovery procedures 

implied by the error conditions. 

(Refer to component description and operating 

procedures manual for the device.) 

Ready the device. No response is necessary, 
or 

Cancel all jobs by inserting X'03' in byte 4, 

and press the INTERRUPT key. 




Either; 
Insert X'02' (IGNORE) 
in byte 4, 

or 

Insert X'03' (CANCEL) 
in byte 4, and press the 
INTERRUPT key 



System operation 
continues 



Operator procedure to recover from an input/output device error, when the device 
error recovery message cannot be printed on either SYSLOG or SYSLST. 
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WAIT STATE 
MESSAGES 



2. Hardware failure 

If a hardware failure occurs that cannot be corrected by the RAS transients 
(R-transients), a message is normally printed on SYS LOG. If this is not 
possible a coded message is placed in low address storage. 



A complete list of wait state messages is given in table E-3. 



3. Unrecoverable I/O error during FETCH 

If an unrecoverable I/O error occurs during a FETCH operation, a coded message is 
placed in the low address storage bytes 0-3. 

The contents of the following 24 bytes starting at byte 4 will contain device sense 
information. 

(The number of sense bytes is device-dependent). 

The sense data is useful to your IBM customer engineer and may also be of use 

to your system programmer. The component manual for the failing device provides 

details about the cause of failure. Before repeating IPL, try a different drive. 



^S 
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A linkage editor map is an aid to program debugging. This map is obtained during 
link-editing when SYSLST is assigned (unless ACTION NOMAP was specified). 
Details about link -editing are found in DOS/VS System Control Statements. 



Description 

When used in conjunction with a storage dump and program listings, the linkage 
editor map will help in locating programs and subroutines that are included in the 
programs at object time. Common areas, load address, relocation factors, low and 
high addresses are also shown. In addition, the PHASE card is displayed to show 
where the phase was loaded, which is also helpful when working with multi- 
phase programs. 

The linkage editor map also shows where programs should be located in virtual 
storage, where overlays are loaded, and whether the program is relocatable, self- 
relocating, non- relocatable or SVA-eligible. The example below shows a linkage 
editor map. 



Other Aids 

THE LINKAGE 
EDITOR MAP 





























12/06/73 PHASE 


XFR-AD 


LOCORE 


HICORE 


DSK-AD 


ESQ TYPE 


LABEL 


LOADED 


REL-FR 








• PHASE*** 


040078 


040078 


04232F 


047 13 3 


CSECT 

CSECT 

* ENTRY 

CSECT 

CSECT 

* ENTRY 

CSECT 


BEGIN 

IJFFZZWZ 
IJFFZZZZ 

IJCFZIZO 

IJDFCZZZ 
IJOFZZZZ 

IJ2L0067 


040078 

041E08 
041ED8 

042230 

0422A0 
0422A0 

0422F8 


03C878 RELOCATABLE 
041 ED8 

042230 
0422A0 

0422F8 


^ (fx 6o Kr) 






























The next two illustrations show an example of the DIAGNOSTIC OF INPUT, 
and virtual storage MAP, which are printed on SYSLST during link-editing. 

The example contains errors which are discussed in the text following each figure. 



How to use 

Refer to A-2 in this section for an example that shows how the map is used during 
debugging in conjunction with a system dump and program listing. Examples at 
the end of this chapter show the information reports that immediately follow the 
map. These reports confirm that the new phase, or phases, are correctly cataloged, 
and enable you to monitor the status of your libraries. 
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THE LINKAGE 
EDITOR MAP 



JOB 

ACTION 

LIST 

LIST 



EXAMPLE 



DISK LINKAGE EDITOR DIAGNOSTIC OF INPUT 



LIST 
LIST 



8 


LIST 


9 


LIST 


10 


21411 


11 


LIST 


12 


21311 


13 


LIST 


14 


LIST 


15 


LIST 


16 


21441 


17 


LIST 


18 


LIST 


19 


LIST 


20 


LIST 


21 


21021 


22 


LIST 



TAKEN MAP CLEAR 

PHASE PHASE1,ROCT,NOAUTO 
INCLUDE ,(NAMEONE) 



21411 EX1 0002 ESD 404040 0010 0002 POINT3 1 000244 000003 NAMETWO 2 FF0130 0000CA NAMTHREE 000200 0000A8 



PHASE PHASE2,x,NOAUTO 
INCLUDE .(NAMEFOUR) 

EX1 0002 ESD 404040 0010 0002 POINT3 1 000244 000003 NAMETWO 2 FF0130 OOOOCA NAMTHREE 000200 0000A8 

PHASE PHASE3,PHASE1+73,NOAUTO 
INCLUDE ,(NAMETWO,NAMTHREE) 

EX1 0002 ESD 404040 0010 0002 POINT3 1 000244 000007 NAMETWO 000130 001898 NAMTHREE 000200 0000A8 

INCLUDE RELMOD 

INCLUDE RELMOD 

EX1 0002 ESD 404040 0010 0002 POINT3 1 000244 000003 NAMETWO 000130 001928 NAMTHREE 000200 0000A8 

PHASE PHASE4.+16500 
INCLUDE RELMODUL 

REL 0015 TXT 00425C 0038 F0F1 1A361A56 46D0E254 4130EF1E D500EF1E E5FA477C E2869201 EF1E0630 9509EF1D 4770E286 

AUTOLINK AUTOMOD2 

PHASE PHASE5,+X'25BA',NOAUTO 
REP 0C4018 0034130,C03A,47F0,C30E PATCH ASSEMBLY ERRORS 

REP 0C40CC 003D20E, 

REP 0040C0 C3F0 0003 D20EF0C5 6B404040 40404040 40404040 40404040 40404040 40404040 40404040 40404040 
ENTRY INVALID TRANSFER LABEL 



^taurf^ 



Line 1 (ACTION TAKEN). MAP and CLEAR have been specified on separate ACTION cards. Had NOAUTO been specified, it would 
also appear on this line. 



Lines 4, 7, 10, and 1 3. Error 2141 1 (duplicated ESID number) is printed four times because the submodular structure of the phase 
demanded four passes over the same module. As the linkage editor processes in its own input area, the record printed may not be 
identical to the original input record. Lines 10 and 1 3 differ in content from lines 4 and 7 for this reason. 



Lines 11 and 12. Line 11 is printed when the statement is read by the linkage editor. Line 12, error 2131 1 indicating that the 
requested module is not in the relocatable library, is printed after the error is detected. 



Line 16. This is an example of an error detected in a TXT statement. Error 21441 indicates that the ESID number F0F1 is invalid. (It 
should be binary 01.) 



Line 17. Indicates the AUTOLINK feature was used for relocatable library module inclusion in the phase named above it. 



Line 19. An example of a valid REP statement. 



Lines 20 and 21. An example of an invalid REP statement. Line 20 is printed when the statement is read by the linkage editor. 
Line 21, error 21021 indicating an invalid operand in the statement, is printed after the error is detected. 



When a module is included from the relocatable library, it is not possible to guarantee that the sequence identification printed in 
columns 8- 1 5 is that of the record printed. This occurs because the MAINT librarian program reblocks the content of the cards to a 
more compressed format. 
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2 . 1 82 Serviceability Aids. 



Other Aids 

THE LINKAGE 
EDITOR MAP 



1 


PHASE 


XFR-AD LOCORE 


HICORE DSK-AD 


ESD TYPE 


LABEL 


LOADED 


REL-FR 




2 


COMMON 






COM 




001800 


0000C8 




3 


ROOT PHASE1 


0018C8 0018C8 


0019F7 013 2 2 


CSECT 


NAMEONE 


001 8C8 


0C18C8 


NOT RELOCATABLE 


4 








ENTRY 


POINT1 


0018CC 






5 








x ENTRY 


POINT2 


001930 






6 


PHASE 2 


0019F8 0019F8 


001A87 013 3 1 


CSECT 


NAME FOUR 


001 9F8 


0C1750 


NOT RELOCATABLE 


7 


OVEROOT PHASE 3 


0019E8 001918 


001 B1F 013 3 2 


CSECT 


NAMETWO 


001918 


0017E8 


NOT RELOCATABLE 


8 








CSECT 


NAMTHREE 


0019E8 


0C17E8 




9 








x ENTRY 


POINT3 


001 A2C 






10 








CSECT 


NAMEFOUR 


001 A90 


0C17E8 




11 


PHASE4 


0043A0 004140 


0059A3 013 4 1 


CSECT 


AUTOMOD1 


004140 


003A98 


NOT RELOCATABLE 


12 








ENTRY 


AUTOENT 


0042D0 






13 








CSECT 




0043A8 


0C3EF8 




14 








CSECT 


AUTOMOD2 


0043C0 


0003C0 




15 


PHASES 


002688 002688 


002767 013 6 1 


CSECT 




002688 


-001 B08 


NOT RELOCATABLE 


16 








CSECT 


NAME 5 


002688 


-001 B08 




17 


•UNREFERENCED SYMBOLS 




EXTRN 


POINT2 








18 








EXTRN 


POINT4 








19 


ROOT STRUCTURE OVERLAID BY SUCCEEDING PHASE 












20 


POSSIBLE INVALID ENTRY POINT DUPLICATION IN INPUT 












21 


INVALID TRANSFER LABEL ON END OR ENTRY STATEMENT IGNORED 










22 


CONTROL SECTIONS OF ZERO LENGTH IN INPUT 












23 


002 UNRESOLVED ADDRESS CONSTANTS 














24 


003 ADDRESS CONSTANTS OUTSIDE LIMITS OF PHASE 














o 



Line 2 (COMMON). The entry under REL-FR contains the length instead of the relocation factor in the case of ESD-type COMMON. 



Lines 5 and 9 (referring to UNREFERENCED SYMBOLS). These ENTRY labels (POINT2and POINT3) are not referenced as 
external symbols, that is, by corresponding EXTRN statements. 



Line 17 and 18. These labels indicate EXTRN references that cannot be matched with a corresponding entry point. In such a case 
*ENTRY ESD-types may be the corresponding, but misspelled, point. In the submodular structure, CSECTs not specified in any 
namelist appear as EXTRNs. The labels can also indicate unreferenced EXTRNs. 



Line 3, 6, 7, 1 1 , and 1 5. All phase origins (entries under LOCORE) are incremented by the length of COMMON. 



Line 19. Warning message. When this message appears, OVEROOT is printed to the left of the name of the phase (PHASE3) that 
overlays the ROOT phase. 



Line 20. Warning message. An entry label appeared at least twice in the input stream. At its second (or later) appearance, it was not 
possible to validate it as being a true duplication. The most common reason for this message is submodular structure with (source) 
ENTRY labels defined before the CSECT in which the entry point appears. 



Line 21. An overriding transfer label in the ENTRY statement was not defined within the first phase, or a transfer label was not 
defined in an END statement in its module. 



Line 24. Address constants had load addresses outside the limits of the phase in which they occurred. This usually occurs if the 
control section length is incorrectly defined in the input. 



Line 22. Warning message. The COBOL, FORTRAN, RPG,and PL/I (D) compilers do not supply all of the information required 
by the linkage editor in the ESD records. Specifically, the control section length is provided in the END record. If a control section 
defined in the ESD information has a length of zero, it normally indicates that the length is to appear in the END record. It is 
possible to generate zero-length control sections through assembler. Such a condition produces this message. This is not an invalid 
condition if it is not the last control section that is of zero length. If the last control section is of zero length, the length is implied 
to be in the END record and, if not present, causes an error condition. 



Line 23. These address constants correspond to the EXTRNs shown in line 1 7 and 1 8. 
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THE LINKAGE 
EDITOR MAP 



SYSTEH OIRECTORY— SYSRES 


CORE- 


-IMAGE 


RELOCATABLE 


SOURCE-STATEMENT 


PROCEDURE 




* 12/06/73 

* DIRECTORY 
OIRECTORY 

. DIRECTORY 












Mr 




















STARTING ADDRESS 
NEXT ENTRY 
LAST ENTRY 


C 
00 
00 
00 


H 
10 
11 
14 


R 
01 
15 
15 


E 

15 
17 


C H R E 
16 00 01 
16 01 07 02 
16 04 17 19 


C 
31 
31 
31 


H 
00 
00 
04 


R 
01 
08 
27 


E 

03 
09 


C 
41 
41 
41 


H 
00 
00 
04 


R E 
01 

03 04 
27 09 




LIBRARY 
. LIBRARY 
' LIBRARY 


STARTING ADDRESS 
NEXT AVAILABLE ENTRY 
LAST AVAILABLE ENTRY 


00 
13 
15 


15 
13 
19 


01 
02 
04 




16 
27 
30 


05 01 
04 05 
19 16 


31 

38 
40 


05 
14 
19 


01 
05 
27 




41 
41 
45 


05 
09 
19 


01 
22 

40 




OIRECTORY 


ENTRIES ACTIVE 


537 








457 




68 








19 








LIBRARY 
LIBRARY 
LIBRARY 
LIBRARY 


BLOCKS ALLOCATED 
BLOCKS ACTIVE 
BLOCKS DELETED 
BLOCKS AVAILABLE 


1220 

1033 

00 

187 








4720 

35 08 

00 

1212 




5265 

4027 

00 

1238 








3795 

176 

00 

3619 








AUTOMATIC 


CONDENSE LIMIT 


00 








00 




00 








00 








LIBRARY 
DIRECTORY 


ALLOCATED CYLINOERS 
ALLOCATED TRACKS 


15 
05 








15 

05 




10 
05 








05 
05 






(£*6,/W) 



An example of the SYSTEM DIRECTORY status information printout that 
immediately follows the MAP, after cataloging a phase to the system core image 
library on SYSRES. 







PRIVATE OIRECTORY 
* j 12/06/73 
















PRV-CORE IMAGE 


PRV-RELOCATABLE 


PRV-SOURCE STATEMENT 






















rj< 


* OIRECTORY STARTING ADDRESS 

; DIRECTORY NEXT ENTRY 
1 DIRECTORY LAST ENTRY 


C H R E 
47 10 01 
47 12 06 07 
47 14 15 17 


C H R E 
73 00 01 
73 02 09 13 
73 09 17 19 


C H R E 
103 00 01 
103 01 15 07 
103 09 27 09 










LIBRARY STARTING ADDRESS 
k LIBRARY NEXT AVAILABLE ENTRY 
* LIBRARY LAST AVAILABLE ENTRY 


47 15 01 

71 09 01 

72 19 04 


73 10 01 

98 04 06 

102 19 16 


103 10 01 
196 05 02 
196 19 27 














STATUS INFORMATION— 












DIRECTORY ENTRIES ACTIVE 


631 


848 


412 










' LIBRARY BLOCKS ALLOCATED 

LIBRARY BLOCKS ACTIVE 
k LIBRARY BLOCKS DELETED 
* LIBRARY BLOCKS AVAILABLE 


2020 

1812 

84 

124 


9440 

7909 

00 

1531 


50490 

50086 

00 

404 










k AUTOMATIC CONDENSE LIMIT 


00 


00 


00 










i LIBRARY ALLOCATED CYLINOERS 
I DIRECTORY ALLOCATED TRACKS 


26 

05 


30 
10 


94 
10 


(£x<z*6) 





















( 



pi 



An example of the PRIVATE DIRECTORY status information printout that 
immediately follows the MAP after cataloging a phase to the private core image 
library. SYSTEM DIRECTORY status information, shown above is printed 
following this report. 

Note: The format of this printout depends on whether SYSCLB, SYSRLB, and 
SYSSLB were assigned before the linkage editor run. 
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Other Aids 

Summary THE LINKAGE 

EDITOR MAP 

The following list summarises the information contained in the map. 

1. The name of each phase, the lowest and highest virtual storage locations of 
each phase, and an indication if the phase is relocatable, non-relocatable, 
self-relocating or SVA-eligible. It also shows the disk address in hex where the 
phase begins in the core image library. 

2. An indication if the phase is a ROOT phase, or if a phase overlays the ROOT 
phase in any way (designated by OVERROOT). 

3. The length of COMMON, if appropriate. 

4. The names of all CSECTs belonging to a phase, the address where each CSECT 
is loaded, and the relocation factor of each CSECT. 

5. All defined entry points within a CSECT. If an entry point is unreferenced, it 
is flagged with an asterisk (*). 

6. The names of all external references that are unresolved. 

7. The transfer (execute) address of each phase. 

8. Warning messages are printed if: 

• The ROOT phase has been overlaid. 

• A possible invalid entry point duplication occurred. 

• The ENTRY or END statement contained an invalid (undefined) 
transfer label. 

• At least one control section had a length of zero. 

• The assembled origin on an RLD statement was outside the limits of 
the phase. 

• An address constant could not be resolved. 

These messages may or may not indicate actual programming errors. If NOMAP 
is operational, the warning messages are not printed. 
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Hardware Error Recording and Recovery 



RMS 



General Description of RMS 

The need for the IBM serviceability aids that are collectively termed RMS (Recovery 
Management Support) has been described in Section 1 under the heading 
"Hardware Failures." 

RMS consists of software routines that are grouped according to their function: 

• MCAR (Machine Check Analysis and Recovery) 

• CCH (Channel Check Handler) 

• ERP (I/O device Error Recovery Procedures) 

• RMSR (Recovery Management Support Recorder). 

Each function listed above is considered to be a function of RMS, and if required, 
must be included in your supervisor during system generation. The function RMSR 
consists of several recording facilities: 

Unit check recording 

Machine check and channel check recording 

Tape/disk error statistics by volume 

MDR (Miscellaneous Data Recorder) 

IPL information 1 Reliability Data 

End of Day recording for devices and for the system. J Extractor (RDE) 

RMS is always supported on the Models 135, 145, 155-11 and 158, and the RMSR 
facilities supported depends on the parameters specified during system generation. 
The parameters of the supervisor macros affecting the subjects described in this 
section are discussed here but further details required for generating a supervisor 
are found in the DOS/VS System Generation manual. 

System Requirements 

In order to perform its functions, RMS uses two logout areas contained in real 

storage: 

• The fixed logout area 

• The model-dependent log out area (not applicable to Models 1 15 and 125). 
As the name "model-dependent logout area" implies, the real storage area reserved 
for the logout areas varies for different System/370 Model types. Therefore, if 
you know during supervisor generation that the supervisor will be used on a larger 
model, specify the larger model in the MODEL = parameter of the CONFG super- 
visor generation macro. 

Because the Models 115 and 125 employ both software and hardware recording 
functions a more detailed description on these Models is given in the following 
paragraphs. For the Model 125, a hardware function records CPU and channel hard- 
ware failures on the DISKETTE. This also applies to hardware failures of natively 
attached I/O devices. Device ERP is always supported for all models. When the 
Models 115 and 125 support channel attached I/O devices, or magnetic tape units, 
or teleprocessing, RMSR support must be generated during system generation. 
(RMSR support records until checks on SYSREC.) RMSR support can be generated 
by either the parameter CHAN=YES, or RMS=YES, in the SUPVR system 
generation macros. 

When RMS=YES: hardware failures that occur on all attached I/O devices are 
recorded on SYSREC by the RMSR software routines. However no error recording 
occurs for the Multifunction Card Machine (MFCM) if attached. Simultaneously the 
failures that occur on natively attached devices are also recorded on the DISKETTE 
by a hardware function. In the latter case of RMS=YES, MCAR/CCH records are 
recorded on SYSREC as well as on the DISKETTE, and the RDE facility is also 
supported. 

When RMS=NO and CHAN-YES: the supervisor generated supports RMSR for 
channel attached devices, tape units, TP and MCH/CCH. Therefore hardware 
failures that occur on these devices are recorded on SYSREC by the software 
routines as well as being recorded on DISKETTE by the hardware recording 
function. In this case however RDE is not supported. 

When RMS=NO, CHAN=NO and MCH=NO: no recording occurs on SYSREC and 
a hard wait is entered on the occurrence of a hardware failure 



I \ 
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Legend 



■*- Data flow 

•+- Manual control 



Hardware Error Recording and Recovery 

RMS 



Hardware errors 



Operator communications 



Notes: 

7. Not applicable to Models 1 15 and 125. 

2. Not applicable to Models 115 and 125. 
that does not support the RMSR 
function. 

3. Use the U hardware command 
for a Model 1 15 and 125 that 

does not support the RMSR function. 



CPU errors 



Hardware instruction retry 
(HIR). Error checking and 
correction (ECC) 



Channel, control unit or 
device errors 



Use the MODE command to: 

• Set HIR or ECC to recording or 
quiet mode. (See note 1 ) 

• Change the error frequency limit, 
(EFL) threshold values for HIR 
and ECC. (See note 1) 

• Inquire about the status of 
present recording mode. (See 
note 1) 

• Set the recording mode for tape 
error statistics (TES) recording. 
(See note 2) 

• Change type of recording for 
a specific device. (See note 2) 





Machine check 
and 

input/output 
interrupts 



Hardware control 



Software control 



Messages printed on SYS LOG or 
displayed on DOC inform operator 
of a hardware failure. 



DISKETTE 




Error 
Data 



Recovery Management Support (RMS) 

• Check severity of the error 

• Attempt recovery from the error 

• Record the error on SYSREC 

• Print informative messages on SYSLOG. 



Issue ROD command at 
system switch-off, or at end of 
shift, or end of day. (See note 3). 
IPL reason information 
(See note 2) 



Messages on SYSLOG inform 
operator about status of 
SYSREC, (Full, overflow, etc.) 



System 
recorder 

file. 
SYSREC 



EXEC EREP. Initiated by job 
control statement. 



Select System/370 EREP options 
by control statements. 



t 

I 

I- 



No recording on SYSREC 
occurs on Models 1 15 and 
125 when RMS = NO 



System/370 EREP 



«*- System/370 EREP options. 
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Hardware Error Recording and Recovery 

RMS Operation 



An understanding of the purpose and operation of RMS will help when 
interpreting the EREP printout and the System/370 Models 115 and 125 
Maintenance Log Analysis Feature. 

The following four figures show the relationship between the hardware and 
software recording facilities, and show the connection between the DISKETTE 
(Models 1 15 and 125 only), the SYSREC file, and the EREP options. 

Figure F-l-A shows the types of machine checks generated and the real storage 
used for the logout areas. Error information is first logged in this area before being 
used by the RMS software routines. On the System/370 Models 1 15 and 125, 
the logout area is replaced by the DISKETTE recording file. 

Figure F-l-B describes the division of machine check interrupts into soft machine 
checks and Figure F-l-C illustrates the general flow of processing after a hard 
machine check occurs. 

Figure F-l-D expands the RMS routines into: 

• MCAR 

• CCH 

• Channel check ERPs that are initiated by CCH routines for device-dependent, 
channel error recovery. 

• Unit check ERPs that handle the unit check conditions of the devices. 

This figure also shows how the errors are first checked for their severity, and shows 
how the effect on system operation depends on the type and severity of the error. 

Figure F-l-E shows the types of records that are recorded on SYSREC. 

Figure F-l-F represents the EREP options that can be selected by the operator. 
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Hardware failure 



CPU 
retry 
failures 



Hardware Error Recording and Recovery 

RMS 



Main storage or control storage 
(ECO failures 



HIR 



Storage 

error 

corrected 



Input/output 
channel or 
control unit 
device failures 



Storage 

error 

uncorrected 



CD 
Time of 
day clock 
damage 



TD 
Timer 
damage 



Key in 
storage 
uncorrected 



T 



PD 
Instruction 
processing 
damage 



SR 
System 
recovery 



ED 
External 
damage 



SD 
System 
damage 




f> 



Machine check interrupts 





I/O interrupts 



Hard machine check interrupts 



Soft machine check interrupts 



For the Models 115, 125 
and 1 58 log out areas 
are replaced by the 
DISKETTE 



PSWs, CSW, CAW 
timer 



I/O communications 
area 



Fixed logout 
area 



CPU extended 
logout area 



Extended channel 
logout area 



Figure F-1-A illustrates how data about a hardware error is logged in 
fixed areas of real storage, or on the DISKETTE. 
This data is used by soft ware routines for error recovery (where 
possible), and for recording the data on SYSREC. 
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RMS 



Successful 

CPU retry 

HIR 

(Not applicable to 

Models 115 and 125) 



X 



Soft Machine Check Interrupts 



ECC single-bit inter- 
mittent processor 
storage correction 
(if enabled by 
operator) 

1 



For a Model 1 15 or 125 that does not 
support the software MCAR/CCH, a 
coded message is placed in general 
register 11(X'B') and low address 
storage and system operation is 
terminated. 



I 



External Damage 
(Not applicable to 
Models 1 15 and 125) 



Log status and 
record report 
on SYSREC 



Inform operator 
of action; 
continue processing 



Interval 

timer 

damage 



Time of Day 
Clock damage 



Only applicable 
to the Models 
115 and 125 
if RMS=YES 






Figure F-l-B. General flow of DOS/VS MCAR processing after soft machine check interrupts 

Hard Machine Check Interrupts 





I 




1 






I 




1 










Uncorrectable 
or unretryable 
CPU error 
associated 
with control 
program 




Multiple-bit 
processor storage 
error in 
processing program 






Uncorrectable 

or unretryable 

CPU error 

associated 

with 

processing 

program 




Multiple-bit 
processor storage 
error in 
control program 




System damage 
or multiple-bit 
control 
storage error 


































Storage protect 
key failure 






































External Damage 
(Applicable to 
Models 1 15 and 
125 only) 








1 
















Attempt 
repair 
procedure 
and continue 






Log status and 
record data 
on SYSREC 
































Attempt 
logging and 
recording 
of status 


















Attempt 
logging and 
recording 






















1 






Determine 
task affected; 
log status and 
record on 
SYSREC 






Inform operator 
and terminate 
system operations 














1 










Validate 
the error 


, 


Inform operator 
and terminate 
system operations 




Hard Wait 


| 














Diagnostic 

procedures 

(EREP) 

IBM customer 

engineer test 














y^ Error ^^ 

^v validated ,/ 1 






Log status and 
record results 
on SYSREC 
and inform 
operator 






















DRAP 
Dynamic 
Re-allocation 
of Partitor 
or page pool 




Hard Wait 
























Terminate 
affected task and 
inform operator 










| 












HARD WAIT 






DIAGNOSTIC 






I 






1 






Procedi 

EREP 

SEREP 


jres 












Continue 

system 

operation 






Cancel task 
and continue 
system operation 








Figure F-l-C. General flow of DOS/VS MCAR processing after hard machine check interrupts 
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i Not applicable to Models 1 1 5 and 1 25 I 



I/O Channel 
errors 



I/O control 
unit or 
device errors 



CPU 
errors 



Main storage or 
control storage 
errors 



HIR 



ECC 




Automatic retry and correction 
procedures by hardware 



Generate I/O 
interrupt 



J Generate machine 
check interrupt 




Automatic System Action 



zzn. i 



• Save data about 
the error in register 

• continue processing 
in a degraded mode 



Software routines 



I/O control 
unit or device 
errors 



I/O 

channel 

errors 



CPU 

instruction 
errors 



Main storage or 
control storage 
errors 



MCAR 
CCH 
ERP 
RMSR 



TES 



Accumulate 
Device status 
Data in PUB2 



Record PUB2 
counter infor- 
mation for device 
onSYSREC, if 
counter overflow 
or IPL/EODor 
ROD command 




Machine Check Analysis Recovery 
Channel check Handler 
Device Error Recovery Procedures 
Recovery Management Support Recorder 
(For Models 115 and 125, RMSR is only 
required for channel attached devices, 
TP, and tape units. For natively attached 
devices, recording is via hardware) 
Tape Error Statistics. 

Automatic System Action 



Attempt to record data about 
the error on SYSREC 



• Attempt to print a message 
on SYSLOG 

• Place system in hard wait 



Yes 



Yes 



Record data about the error 
on SYSREC 



Print message on SYSLOG 
Terminate job in which 
error occurred 
Continue processing 
with next job 




Record data about the error 
onSYSREC 



Print message on SYSLOG 
Terminate job in which 
error occurred 
Continue processing with 
next job 



Record data about the error 
on SYSREC 



• Print message on SYSLOG 

• Continue processing the job 



Figure F-1-D Illustrates the connection between hardware error detection 
and software routines that enable data about the error to be recorded. It 
also shows the system action taken, depending on the type of error. 



Record data about the error 
onSYSREC 



• Print message on SYSLOG 

• Continue processing the job 
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MCAR/CCH 



Unit check 



Counter 
overflow 



IPL/EOD * 



SYSREC* 



Miscellaneous 
data record 
(MDR) 



System 
Recorder File 
(Can be either 
on SYSRES or 
on a separate DASD) 



Tape error 
statistics (TES) 



Teleprocessing 
error records 
(TPER) 



*For the System/370 Models 1 15 and 125 the operator 
must save the disk usage counters at the end of the day, 
(or end of shift or prior to system switch off) by using 
the U command of the mode select display. 

** For the Models 115 and 125 recording on SYSREC is 
applicable only when the RMSR function is generated. 

Figure F-l-E Input records to SYSREC. 



EREP 

(Not applicable to Models 1 15 and 125 
not supporting RMSR function) 

EREP options: 




Edit and print the entire SYSREC file 



Selectively retrieve records from the 
SYSREC file or History/RDE tapes 
for editing and printing 



Edit and print tape error data on 
the SYSREC file 



Summarize the SYSREC file 
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tapes 
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Statistic tape 



Summarize tape error data from 
SYSREC to the History tape 



Clear the SYSREC file 
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Figure F-l-F Output from SYSREC. 

(Selected by EREP options.) 
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Components 

The software routines required to support the RMS options are: 
Resident MCH 
Resident CCH 
Resident RAS monitor 
Resident DASD ERP 
Device ERP transients (A transients) 
MCH/CCH transients (R transients) 
RMSR transients (A and R transients). 

To record tape and disk error statistics by volume, the option RMSR also uses 
some B transients. A job control module is required to enable RMSR to record 
IPL/EOD data. 

The figures below shows the relative locations, in the real address area, of the 
RTA (RAS transient area), LTA (Logical transient area), and PTA (Physical 
transient area). 

Note: No error recording or recovery can be executed before IPL is successful. 
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For the Models 1 1 5 and 1 25 the model- 
dependent logout area is replaced by 
the DISKETTE 



A-transients 



B-transients 



R-transients 

(Not applicable to a supervisor that 
does not support the Machine 
Check/Channel Check function). 
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Models 115 and 125 



Note: There is no need for 
software control or EFL for 4 
MR on the Models 115 
and 125 



Detailed Description of RMS Functions 

Machine Check Analysis and Recovery (MCAR) 

Two hardware error recovery features, Hardware Instruction Retry (HIR) and 
Error Checking and Correction (ECC), perform hardware correction for machine 
malfunctions. RMSR interfaces with the error correction hardware through 
Machine Check Analysis and Recovery (MCAR). 

When the CPU is in the 'recording mode,' MCAR is informed when a machine 
malfunction occurs and is corrected by means of a 'soft' (or recovered) Machine 
Check Interrupt (MCI). When the CPU is in 'quiet mode' the hardware correction 
routines do not generate a soft MCI if the malfunction is corrected. If the hardware 
correction routines cannot correct the malfunction, a 'hard' (or unrecoverable) 
MCI is generated regardless of the mode setting. 

When a soft MCI occurs, RMSR writes a record in the recorder file containing 
\ identification information and the contents of the machine-independent logout 
| area and the machine -dependent logout area (if available). The operator is 

notified that a soft MCI occurred, control is returned to the interrupted code, and 

system operation continues. 

Dynamic Reallocation of Partition or page pool (DRAP): When a hard MCI occurs, 
the MCAR routine attempts to isolate the failure to a partition in order to cancel 
the damaged task and, if possible, continue, system operation. If the system cannot 
continue because the failure occurred in an area critical to system operation, 
recording is attempted, after which the system enters a hard wait state. 

When a hard MCI is caused by an unrepairable real storage position, MCAR 
dynamically reallocates storage. Informative messages are printed on SYSLOG 
that alert the operator of any action taken by DRAP. 

MCAR Modes of Operation: An error Frequency Limit (EFL) algorithm prevents 
SYSREC from filling up too quickly if a large number of intermittent failures 
occur. The initial IBM -supplied EFL and either eight (Models 155-11 and 158) or 
sixteen (Model 145; eight for control storage and eight for processor storage) soft 
ECC MCIs within an eight-hour period. These values are set at system generation 
time and can be changed by the MODE command. A message is issued on the first 
occurrence of a soft MCI on a System/370 Model 135 and all recoverable machine 
checks are disabled. The MODE command must be issued to re-enable reporting of 
soft machine checks. These values are set at system generation time but can be 
changed by the MODE command. 

MCAR supports EFL for two hardware facilities: 

• Hardware Instruction Retry 

• Error Checking and Correction. 

EFL Threshold Values: At IPL time, the EFL threshold values are established so 
that the EFL algorithm controls the number of soft MCIs recorded. These 
values are: 

• The number of soft MCIs 

• A specific time period. 

When these EFL values are reached, a change in modecof operation occurs. Until 
the EFL threshold values are reached, the system operates in recording mode. 
This is the normal mode of operation in which an MCI occurs for all machine 
check conditions. After the EFL threshold values are reached, ECC (or ECC and 
HIR) is placed in quiet mode. In quiet mode, no MCIs occur for recovered errors; 
therefore, the number of corrected errors is unknown. 

EFL threshold values are not applicable to the Models 115 and 125 owing to the 
recording of erros by a hardware function. 
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Hardware Instruction Retry (HIR) Modes: The two HIR modes are: RMS 

• Recording. A soft MCI occurs for every hardware instruction correction. 

• Quiet. No soft MCI occurs for hardware instruction correction. (Recording 
is always quiet for the Model 125.) 

Error Checking and Correction (ECC) Modes: The ECC modes are: 

• Recording. A soft MCI occurs for every main or control storage correction. 

• Quiet. No soft MCI occurs for real or control storage correction. (Recording 
is always quiet for the Model 125.) 

• Threshold (Model 145 only). A soft MCI occurs after a predetermined 
number of unrecorded control storage errors have occurred within a given 
time period. Threshold mode is a hardware function and is not affected by 
EFL threshold values. 

If HIR is in quiet mode, ECC is also in quiet mode. When ECC is in quiet mode, 
HIR can still be in recording mode. 

At IPL time the system assumes the IBM-supplied EFL threshold values; these 
values can be changed by the MODE command. When IPL is completed: 

• For the Model 145, recording mode is entered for HIR, quiet mode is 
entered for main storage ECC, and threshold mode is entered for control 
storage ECC. 

• For the Models 155-1 1 and 158, full recording mode is entered for both 
HIR and ECC 

Channel Check Handler (CCH) 

When a channel check occurs, channel error information is logged and an interrupt 
is generated. The CCH resident program investigates the severity of the malfunction. 
If the severity is such that system operation need not be immediately terminated, 
the CCH resident program: 

• Builds the Error Recovery Program Interface Bytes (ERPIB) containing 
error information for use by the appropriate CCH/ERP 

• Records the error information on the recorder file 

• Attempts to isolate the error to a device. 

If the error cannot be isolated to a device, CCH cancels all problem programs that 
use the malfunctioning channel. If the error can be isolated to a device and the 
device is supported by a CCH/ERP, the appropriate CCH/ERP is loaded into the 
R-transient Area (RTA). Then ERP examines the ERPIB supplied by CCH and 
determines the severity of the error. Whenever possible, the failing channel 
command is retried. If the command cannot be retried, or if retry fails, a message 
is written on SYSLOG, and all problem programs using the failing device are 
cancelled. If recovery is successful, a message is also written on SYSLOG, unless 
SYSLOG was the failing device. Certain retry conditions require manual operator 
intervention to enable proper retry. 

Note: If the 'accept unrecoverable error' bit in the CCB is on, the error is posted 
and control is returned to the problem program. 

If no CCH/ERP is available for an error isolated to a device, all problem programs 
using that device are cancelled. 
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Each I/O device or class of I/O devices has a unique device error recovery routine. 
The appropriate routine is entered from the channel scheduler upon detection of 
an error. The function of the error recovery procedures (ERP) is to attempt 
recovery from the error either through programmed recovery or by operator 
intervention. If recovery is not possible, the following choices are available, where 
applicable: 

1. The error can be ignored. 

2. The task can be terminated. 

3. The problem program can take action (exit to a user routine). 

4. The record in error can be bypassed. 

Depending on the type of error, the type of device, and whether Logical IOCS 
is used, some or all of these options are available. Choices 3 and 4 are available 
through LIOCS only. In the absence of any other options, only choice 2 is 
available. 

At the time the error is first detected, before ERP is called to attempt recovery, 
RMSR accumulates certain information relating to the status of the device in the 
PUB2 for the device. The device ERP then gets control and tries to correct the 
error. If the ERP cannot recover, RMSR builds and writes the unit check record, 
containing the statistical data from the PUB2 and the status and sense information 
at the time the ERP determined the error was unrecoverable. If the ERP recovers, 
the statistical data in the PUB2 is not cleared. This information is recorded at the 
next permanent error for that device, at the next statistical counter overflow for 
that device, or at end-of-day when the operator issues the ROD command. 

Besides the unit check record (written for every permanent error) and the counter 

overflow record (written when a statistical counter becomes full or when the 

operator issues the ROD command), RMSR also writes Tape Volume Dismounts 

records. The data recorded in the Tape Volume Dismount records corresponds 

to the data formerly accumulated in the TEBV table; the EREP TES (Tape Error /f A 

Statistics) options are used to format and summarize this data. 
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SYSREC (System Recorder File) 

The recorder file must be created and assigned to a disk device that is always on 
line. It is assigned after IPL, before the first job. 

The recorder file is not CPU or SYSREC dependent. Thus it can contain records 
from more than one DOS/VS system. 

Once the file is created, no further operator intervention is required, unless the 
recorder file is damaged or the operator action listed in the DOS/VS Messages 
manual specifically requests the file to be re-created. For example, message 

0T03I ERROR ON RECORDER FILE. 

On subsequent IPLs the system opens the recorder file and continues to update it. 

Note: Recording on the recorder file is suppressed during execution of the 
EREP program. 

Creating the Recorder File: The method of creating SYSREC and the job stream 
needed depends on whether the file is to be part of the system residence unit 
SYSREC, or whether it is to reside on a separate disk volume. 

For details and job stream examples, refer to the DOS/VS System Management 
Guide. 

SYSREC Record Types: SYSREC contains variable-length records with a maximum 
size of 200 bytes (including a standard 24-byte header). The types of recording 
that RMSR performs are: 

• MCAR recordings 

• CCH recordings 

• Unit check recordings 

• Counter overflow recordings 

• Tape volume statistics recordings 

• IPL/EOD recordings 

• Miscellaneous Data Recorder (MDR) recordings 

• Teleprocessing error records (TPER). 

MCAR: Formats an environment record (recovery report) after a soft machine 
check. 

The record is written on the environment recorder data set (ERDS), which has 
the symbolic name SYSREC. The record contains the following pertinent 
information about the error: 

Status information from the fixed logout area in real storage 

Recovery action 

Program identification 

Date 

Time of day. 

CCH: Formats an error information block for use by the ERP routines after an I/O 
interrupt, caused by a channel check. 

The record is written on SYSREC, and contains the following information: 

• Status information from the logout area 

• The ECSW (extended channel status word) 

• Date 

• Time of day. 

MCAR also records data on SYSREC about hard machine checks. 



RMS 



Note: Not applicable to the 
Models 115 and 125 using 
a supervisor that does not 
support the RMSR function. 
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RMS UNIT CHECK RECORD: Device ERPs attempt recovery from an error, usually 

by retrying the failing channel command. If the error is not corrected after a 
certain number of retries, RMSR writes a unit check record which contains 
hardware information (sense data), statistical data, and identification data. All 
information relevant to the status of the device at the time the failure is recognized 
as permanent is contained in this record. One unit check record is written for each 
permanent error. RMSR resets the statistical counters in the PUB2 table at the 
same time. 

COUNTER O VERFLOW RECORD: Whenever a statistical counter in the PUB2 
table fills up, a counter overflow record is written on SYSREC. The counter 
overflow record is also written for each device that has unrecorded statistics when 
the operator issues the ROD command. The statistical counters in the PUB2 table 
for the device are cleared at the same time. 

IPL/EOD: I/O error logging for System/370 users includes RDE (Reliability Data 
Extractor). If ERRLOG=RDE is specified during system generation, RDE gathers 
hardware reliability data that IBM personnel use to evaluate hardware performance. 
Two types of records are written on SYSREC by RDE: 

• An IPL record. This specifies the reason for IPL. 

• An EOD (End-of-Day) record. This is initiated by the ROD command, which 
should be issued before the system is shut down. 

EREP uses these records to identify RDE data. 

For the System/370 Models 115 and 125 the operator must save the disk usage 
counters at the end of the day (or end of shift or prior to system switch-off) by 
using the U command of the mode select display. 

MISCELLANEOUS DATA RECORDER (MDR): RMSR makes recordings on the 
SYSREC file for the 321 1 printer buffer errors and the 3330 and 3340 Disk 
Storage errors. 

TAPE VOLUME DISMOUNT RECORD: When processing standard labelled tapes 

using LIOCS, RMSR makes a recording on SYSREC each time a new volume serial ,4 ~~\ 

number is detected. When the tape is opened, the number of the current tape is U V 

compared with the serial number in the PUB2 for that tape drive. If the serial 

numbers are different, a volume dismount record, containing volume usage and 

Tape ERP recovery statistics, is written on SYSREC. The statistical counters in the 

PUB2 relating to usage and error recovery action are cleared and the serial number 

is updated. Processing continues and statistical data for the new tape is accumulated 

in the PUB2 table. 
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TES (Tape Error Statistics) R MS 

A major factor affecting the quality of an operating system is the condition of the 
volume stored on a magnetic medium, such as tape. Such a medium is subject to 
contamination from dust, foreign materials, fingerprints, and particles of oxide 
coating. 

Because of these environmental factors, it is desirable to record the number of 
read and write errors occurring on each tape volume. By monitoring the error 
rate, a report can be kept on the condition of each tape volume in a tape library. 

System Requirements: For Tape Cartridge Readers. When error statistics are 
required to monitor tape cartridges used on the 2495 Tape Cartridge Reader 
specify TEB = n in the FOPT macro, (n specifies the number of tape cartridge 
readers attached to the system.) 

For magnetic tape volumes when error statistics are required to monitor tape 
volumes, specify TEVB=IR or CR in the FOPT macro. 

For all standard labeled tapes, tape statistics are accumulated by volume. For 
unlabeled and nonstandard labeled tapes two types of error recording are 
available: 

• Combined Recording (CR) 

• Individual Recording (IR). 

When TEBV=CR is specified, the error statistics for all unlabeled and nonstandard 
labeled tapes on a specific tape unit are accumulated until a labeled tape is 
mounted and opened on that unit. Then, one recording for the unlabeled and 
nonstandard labeled tapes is made, and the counters are reset in the PUB2 table. 

Specify TEBV=IR to record tape error statistics on the SYSREC file and to reset 
the PUB2 table counters at each OPEN for unlabeled and nonstandard labeled 
tapes. 

The mode of recording for nonstandard labeled and unlabeled tapes can be 
changed with the tape options of the operator's MODE command. 
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Not applicable to the 
Models 115 and 125 
using a supervisor 
that does not support 
the RMSR function 



EVA (Error Volume Analysis) 

This option of RMSR enables you to specify the number of temporary read/write 
errors that can occur on a tape volume before an informatory message is printed 
on SYS LOG. 

System Requirements: The number of temporary read/write errors needed to 
print the informatory message must be specified by EVA=r and/or w the FOPT 
macro during system generation, (r specifies the threshold level of temporary read 
errors, and w specifies the threshold level of temporary write errors.) 

Description and operation: The message that EVA issues to SYSLOG contains the 
number of temporary read errors, temporary write errors, and START I/Os, the 
physical unit identification, and if standard labeled tape is used, the volume serial 
number. 

The message format is: 

4E10I xxxxxx cuu TR-nnn TW-nnn SlO-nnnnn 

where: 

xxxxxx Serial number of standard label volume (blank 

when nonstandard or unlabeled volume is 

being used) 
cuu Channel/unit address (physical unit) 
TR-nnn Number of temporary read errors 
TW-nnn Number of temporary write errors 
SlO-nnnn Number of START l/Os. 

Either the TR=nnn or the TW=nnn field contains one or more than the 
predetermined error threshold specified in the FOPT macro. When the threshold 
is reached, a notification, for example, 0P1 1 , is sent to the system operator. There 
is no interruption in the execution of the problem program. 

How and when to use: When using an unlabeled or nonstandard labeled tape, a 
note can be made of the volume identification of the volume in use when the 
message is received in order to monitor it. 

By monitoring your magnetic tape volumes, a record can be accumulated of 
read/write errors per volume. 

Operational delays caused by old or worn tapes can be avoided by cleaning and 
erasing the volume, or by cutting off the first ten yards of the volume that indicates 
read/write errors. 

Note: The first part of a tape volume contains label information and is the part of 
the tape that suffers more from mechanical friction. Therefore, the oxide coating 
is more likely to cause read /write errors on the first part of a tape than on any 
other part. 
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Operator commands for controlling RMS 

The error recording facility is under the control of the operator. In addition to 
creating the recorder file (SET RF=CREATE) and responding to error messages, 
the operator has the following responsibilities: 

• Matching PUB2 space to devices attached 

• Issuing the ROD command in response to the problem determination action 
of an error message, or prior to turning the system off or performing a 
re-PIL 

• Providing IPL reason information (RDE users only) 

• Issuing the MODE command to set the type of recording accomplished by 
the MCAR/CCH, CE, and tape error statistics portions of RMSR 

• Executing the EREP program and directing EREP to perform the correct 
function. 

The following sections describe these items more fully. 



Matching PUB2 space to devices attached to the system 

During IPL, the following message may be issued: 

01291 INSUFFICIENT PUB2 SPACE AVAILABLE, RE-IPL 

IPL is automatically canceled, and during the re-IPL the operator must delete 
devices until the above message is no longer issued. 

The reason for this message may be a change in system configuration since 
supervisor generation, or it may be that the supervisor in use has not been 
generated for the same amount and type of disk and tape devices. PUB2 (a table 
in the supervisor) contains a counter for statistical data on device operation and 
is used by the RMSR routines. 

Parameters of the IOTAB supervisor generation macro increase the size of PUB2 
to accommodate the counters for devices attached to your system that require a 
larger field than the standard 12-byte PUB2 field. 

The PUB2 table is described in more detail in the DOS /VS Supervisor manual. 

IPL/EOD (End-of-Day) recording 

This RMSR facility enables data to be recorded on the system recorder file 
(SYSREC) about the reason for, and time between, operator IPLs. 

This allows IBM and installation management to monitor IPLs for any selected 
time period, for example, during an 8 hour operator shift. 

When RDE is required, specify ERRLOG=RDE in the SUPVR macro during 
system generation. 

The ROD command (Record on Demand) 

Using this command will ensure that any statistical data held in the PUB2 table 
is added to the recorder file. For System/370 RDE users, the ROD command also 
writes the EOD (End-of-Day) record on SYSREC. The command ROD has no 
operand. BTAM and QTAM use their own separate methods of updating all disk 
counters during closedown or cancel. 

For the System/370 Models 115 and 125, the operator must save the disk usage 
counters at the end of the day (or end of shift or before system switch-off) by 
using the U command of the mode select display. 
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Note: Not applicable to the 
Models 115 and 125 using 
a supervisor that does not 
support the RMSR function. 
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support the RMSR function. 



When to use: 

1. Operator actions listed under appropriate messages in DOS /VS Messages 
indicate when to issue this command. 

2. In order to create meaningful END-OF-DAY records on the system recorder 
file, you must respond with y to the message END-OF-DAY= at system 
shutdown or at the end of every shift. 

(If the END-OF-DAY record is not required, respond with n to the END-OF-DAY= 
message.) 

IPL reason information 

During the processing of the first // JOB statement after IPL, RDE users must 
provide additional information about the system. Message 1I90D IPL REASON 
CODE= is issued on SYSLOG. You must respond to message 1I90D with a Reason 
Code followed by End. 

If a Reason Code is not entered (only the END key is pressed) or if SYSLOG is 
down or not assigned to a 3210, a 3215 or a Model 125 video display unit, then 
the default, DF, is assumed. However, if an invalid code is entered, message 1I89I 
is issued and message 1I90D is reissued until a valid response is made. 

After the Reason Code is entered, message 119 ID SUB-SYSTEM ID= is issued. 
You must respond to message 119 ID with one of the ID codes followed by END. 
The ID codes further identify the reason for performing IPL. The ID codes and 
the reasons are shown in the table below. 



o 



IPL REASON CODE 

CE IBM CE/SE has control of the system 

and is not doing user work. 
DF Default; 

EN Environmental problem (such as: power, 
overheating, etc.) caused failure. 

IE IBM hardware or a IBM-supplied-program 

error that did not require an IBM CE/SE. 
IM IBM hardware of IBM-supplied-program 

error that required an IBM CE/SE. 
ME Media. Hardware error caused by a faulty 

disk pack, reel of tape, cards, etc. 
NM Normal IPL. 
OP Operational problem. Operator error 

or procedural problem. 

UN Unknown. Undetermined error. 

UP A user (non-IBM-supplied) program caused 
the failure. 



SUB-SYSTEM ID 

00 Unknown. Must be used with Reason Codes DF, EN, NM, OP, UN and UP. 

00 is the default. 
10 Processor. CPU, channel (integrated), storage unit, etc. failure. 
20 DASD. A failure occurred in a DASD unit or its associated control unit 

(231 1 , 2314, 2319, 2841 , 3330/3333, etc.) 
30 Other. A device without an ID code (such as a paper tape unit) caused the 

failure. 

40 Magnetic Tape. A failure occurred in a magnetic tape unit or its associated 
control unit (2400, 3400, etc.) 

50 A failure occurred in a card reader /punch, a printer or in its associated 

control unit (2540, 3525, 1403, 2821 , etc.) 
60 MICR/OCR. A magnetic ink character reader (1412, 1419, etc.) or an optical 

character reader (1285, 1287, 1288, etc.) failure. 
70 A teleprocessing failure occurred in a teleprocessing control unit 

(2701,2702, 3705, etc.) 
80 Graphic. A video display unit (2260, etc.) or its associated control unit 

failure. 

90 An IBM-supplied SCP Type 1 or Type 2 program (such as the DOS/VS 
system or one of its components) failure. 

91 An IBM Programming Product failure. 
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Table F-2-A IPL reason codes 



If the ID code is not entered (only the END/ENTER key is pressed) or if SYSLOG 
is down or not assigned to a 3210, a 3215 or a Model 125 video display unit then 
the default, 00, is assumed. However, if an invalid ID code is specified, message 
1I89I is issued and message 119 ID is repeated until a valid response is made. 

Notes: 

1. Always use ID code 00 with Reason Codes DF, EN, NM, OP, UN, and UP. 

2. ID codes 10, 20, 30, 40, 50, 60, 70, 80, 90, and 91 should be used with Reason 
Codes CE, IE, IM, and ME. 

Normal processing continues after the IPL information has been specified. In order 
to create meaningful data on average running time per IPL, you must issue the 
ROD command before the system is shut down at the end of the working day, or 
at the end of a shift. By this procedure, an accurate record can be maintained on 
the system recorder file, which is printed periodically using an EREP option 
explained later in this section. 
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The MODE command 

This command should be used only at the request of your IBM customer engineer. 

/IR 
CR 
CE,cuu [,l[,xx,y] 

,D[,xx,y] 

,N 



RMS 



MODE < 



Not applicable 
to the Model 125 



R 

STATUS 
HIR 
ECC 



•* 



•* 



[,E=eeee] [,T=tttt] 



*Note: When either HIR or ECC is specified, at least one of the optional operands 
within these braces must be selected. THis only valid for the Model 145 when 
ECC,C is specified with the MODE command. 

The mode command provides the following options for controlling RMSR: 
Reset the recording mode for unlabeled and nonstandard tapes. 
Set recording mode for a particular device to intensive, diagnostic, or no 
mode. 

Initiate or suppress HIR (Hardware Instruction Retry) and ECC (Error 
Correction Code) error recording. 

Request the Mode that the system is operating in (the status of the system). 
Change the mode of operation from Q (quiet) to R (recording) or from 
RtoQ. 

Specify EFL threshold value to override the IBM-supplied value. 
Place the Model 145 Control Storage ECC in threshold mode. 

The MODE command is a notational command. Operands of the MODE command 
can be entered in any order and must be continuous with no blanks between or 
within operands). The STATUS operand cannot have any other operands before 
or after it. 

The total length of the MODE command must not exceed 30 characters. 

The table below describes the parameters for the MODE command: 




Note: Not applicable to the 
Models 115 and 125 using a 
supervisor that does not support 
the RMSR function. 



Note: Not applicable to the 
Models 115 and 125. 



Operand 


Description 


IR 
CR 


Recording mode for nonstandard labeled and unlabeled tape. Specify Individual Recording (IR) if you wish to record 
and then reset the tape error statistics at each tape OPEN. Specify Combined Recording (CR) to accumulate all the 
statistics from nonstandard labeled and unlabeled tape on a specific tape unit until a standard labeled tape is opened. 
Then one recording of the statistics from all the nonstandard labeled and unlabeled tapes is made on SYSREC, and 
the statistical counters are reset in the PUB2 table. 


CE 


The recording mode for a device at physical location X'cuu' may be reset. The possible recording modes are: 

b Normal. The default, normal, is assumed. 

1 Intensive. Normal recording continues. In addition, the next seven errors of a particular type (xx,y) or the next 

seven errors of any type (if xx,y is not specified) are recorded. The number of I/O retries required for success is 

also recorded. 
D Diagnostic. Normal recording continues. In addition, the next seven errors of a particular type (xx,y) or the 

next seven errors of any type (if xx,y is not specified) are recorded. The number of I/O retries required for 

success is also recorded. 
N No recording. 

When the recording mode parameter is the last parameter of the MODE command, a check is made to see if all errors 
are recorded. When in intensive or diagnostic mode, it is possible to check for only one type of error. Indicate the 
bit to be examined with: 
(xx,y) where y is the bit (0—7) and xx the byte (0—31 ) of sense data to be checked. 



Parameters for the MODE Command, (part 1 of 2). 
Table F-2-B 
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RMS 



Operand 


Description 


STATUS 
Not applicable 
to Models 1 15 
and 125 


On SYSLOG a report is printed which indicates: 

• The type of facility used (HIR, ECC) 

• System mode of operation 

• Current error count 

• Error count threshold 

• Current elapsed time 

• Time threshold 

• Number of buffer pages deleted. 
The status report formats are: 

HIR,-| >,aaaa/eeee,bbbb/tttt 

For the Model 135: 

For the Model 145: 

R M 
ECC, Q, C,aaaa/eeee,bbbb/tttt 

For the Models 155-11 and 158: 
ECC , J S- ,aaaa/eeee,bbbb/tttt 

BUF DLT=XXX 

where: 

aaaa = Current error count 

eeee .= Error count threshold 

bbbb = Current elapsed time 

tttt = Time threshold 

xxx = Total number of inoperable buffer pages deleted. 


HIR 

Note applicable » 
to Models 1 15 
and 125 


Hardware Instruction Retry. This operand changes the mode of the HIR facility to R or Q and/or modifies 

the error count threshold and/or time threshold. 

Note: When HIR is placed in quiet mode, ECC also goes into quiet mode. 


ECC 

Not applicable 
to Models 1 15 
and 125 


Error Correction Code. This operand changes the mode of the ECC facility to R or Q, and/or modifies the 
error count threshold and/or time threshold. ECC,R and ECC.Q are the only valid modes of diagnosis for the 
Model 1 35. If ECC is specified for a Model 145, M or C must also be specified. ECC can also place the 
Model 145 control storage in threshold mode. 

Note: Use of the Error Correction Code (ECC) in full recording mode may cause severe system degradation. 
Thus, the (ECC, M/C,R) operand combination of the mode command should only be used by the customer 
engineer or at his request. 


R 


Recording Mode 

MODE R - places both HIR and ECC in recording mode. 

MODE HIR,R - places HIR in recording mode. 

MODE ECC,M,R (Model 145) — if HIR is already in recording mode, main storage is placed in recording mode. 

MODE ECC,C,R (Model 145) — if HIR is already in recording mode, control storage is placed in recording 

mode. 

MODE ECC, R (Models 155-11 and 158) — if HIR is already in recording mode, it places ECC in recording 

mode. 


Q 

Not applicable 
to Models 1 15 
and 125 


Quiet Mode 

MODE HIR,Q - places both HIR and ECC in quiet mode. 

MODE EEC,Q (Model 135, 155-11 and 158) places ECC in quiet mode. 

MODE ECC,M,Q (Model 145) — places main storage in quiet mode. 

MODE ECC,C,Q (Model 145) — places control storage in quiet mode. 


Mor C 

Note applicable 
to Models 1 15 
and 125 


Main or control storage: M or C is only valid for the Model 1 45. 
M or C must be specified when ECC is specified for the Model 145. 
M indicates main storage and C control storage. 


TH 


Treshold Mode: on the next occurrence of an ECC control storage error, control storage is placed in quiet 
mode. TH is only valid for the Model 145 if ECC,C is specified. TH places the Model 145 control storage 
ECC in threshold mode. 


E=eeee 
T=tttt 


Values entered for E and T must be within the following decimal ranges: 

E— 8 (initial value) through 9999 (Error Count threshold) 

T-8 (initial value) through 9999 (Time threshold) 

The IBM-supplied value is 8. 

Note: Whenever HIR is in quiet mode, ECC mode must not be changed. 

For the Model 1 35, the only valid mode commands are: 

MODE CE,... 

MODE STATUS 

MODE ECC,Q 

MODE ECC,R 
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Hardware Error Recording and Recovery 

The EREP program edits and prints error statistics records that have been stored on ER EP 

the recorder file (SYSREC) by RMSR. 

Note: Not applicable to the 
System Requirements Models 115 and 125 using 

a supervisor that does not 
Before it can be executed, EREP must be cataloged to the core image library. support the RMSR function 

Check with the person in your installation who is responsible for creating or 
maintaining the core image library to ensure that the EREP program is cataloged. 
The link-edit statements for cataloging EREP are in the DOS /VS System Generation 
manual. 

The EREP program is a modular, self-re locating program. If the supervisor is 
batched-job only, however, EREP must be link -edited to the end-of-supervisor 
address. It can run in a real or virtual partition using standard job control 
statements. When the environmental data is needed or the SYSREC file becomes 
full, EREP can be executed from SYSLOG or SYSIPT. 

EREP can perform any combination of the following options: 
Edit/print the entire SYSREC file 
Create or update the history/RDE tapes 

Selectively retrieve records from the SYSREC file or history/RDE tapes 
for editing and printing 
Summarize the SYSREC file 
Create or update a TES history tape 
Edit/print TES data from the SYSREC file 
Summarize TES data from the SYSREC file or history tape 
Clear the SYSREC file. 

Tables F-3-A and B show how the options are selected and table F-3-C lists the 
logical unit assignments required by EREP. Table F-3-D and the text following 
gives a detailed description of these options. Flowchart F-3-F shows the procedure 
for executing EREP. 
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EREP 



EDIT 

CLEAR 

SUM- 



OPTION \ HIST 



[,NEW] [,2] 
UPNEW 



TES- 

SELECT 

RDESUM 



-GROUP 



OPTION TES 



[,NEW] [,PRINT[,SUM[,SUMTAPE]] [,VOL] 

[,SUM[,SUMTAPE] [,VOL] 
,NOTAPE y,PRINT[,SUM[,SUMTAPE] ] [,VOL] 
\,SUM[,SUMTAPE] [.VOL] 



}J 



Table F-3-A. The options for TES (Tape Error Statistics) 



DISK 

DISKETTE 
TAPE 
MICR/OCR 
GROUP=<UNITREC 
TP 
CPU 
2715 
ALL 



CPU=xxxxxx,yyyy 

where xxxxxx = the CPU volume serial 
number 
WW = the CPU model number. 



Table F-3-B. Parameters for the SUM option. 






LOGICAL UNIT 


COMMENTS 


SYSIPT 


Optional 


SYS LOG 


Required, must be assigned to a 3210, 3215 or 
a Model 125 video display unit 


SYSREC 


Required 


SYS007 
SYS008 


Optional; must be assigned to a magnetic tape unit 
when a TES option is specified. 


SYS009 


Optional; must be assigned to a magnetic tape unit 
for history /RDE options. 



Table F-3-C. Logical units required by EREP. 
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OPTION 


RESULT 


OPTION EDIT 


Edits and prints SYSREC onto SYSLST. 


OPTION CLEAR 


1 .- Edits and prints SYSREC onto SYSLST 
2. Clears SYSREC. 


OPTION SL 
GROUP= < 
CPU=xxxxx 


M 

^DISK I 

DISKETTE 

TAPE 
| MICR/OCR 

UNITREC y 

TP ( 

CPU 

2715 

ALL J 

x,yyyy 


Prints the summarization of SYSREC onto SYSLST. The file is summarized by the 
hardware group(s) listed in the GROUP parameter. 

If records from multiple CPUs appear on the SYSREC file, specify the serial number 
(xxxxxx) and model number (yyyy) of the CPU whose records you wish to have 
summarized. If CPU data is not supplied, records from all CPUs appearing on the 
SYSREC file are summed together. 


OPTION HIST, NEW [,2] 


1 . Creates the history /RDE tape on SYS009 

2. Clears SYSREC. 


OPTION HIST[,2] 


1 . Updates the history /RDE tape on SYS009 

2. Clears SYSREC. 


OPTION EDIT 

followed by 

OPTION HIST,NEW or OPTION HIST 


1 . Edits and prints SYSREC onto SYSLST 

2. Creates or updates the history /RDE tape on SYS009 

3. Clears SYSREC. 






OPTION TES,NEW 


Creates a TES history tape on SYS007. 


OPTION TES 


Updates a TES history on SYS007. 


OPTION TES,NOTAPE,PRINT 


Edits and prints tape error data from SYSREC onto SYSLST. The data is printed in 
the detail tape unit format. 


OPTION TES,PRINT,NEW 


1 . Creates a TES history tape on SYS007 

2. Edits and prints tape error data from SYSREC onto SYSLST in the detail 
tape unit format. 


OPTION TES,PRINT 


1 . Updates the TES history tape on SYS007 

2. Edits and prints tape error data from SYSREC onto SYSLST in the detail 
tape unit format. 


OPTION TES,NOTAPE,SUM 


Prints the summarized tape data from SYSREC onto SYSLST in the detail tape 
unit format. 


OPTION TES,NOTAPE,PRINT,SUM 


1 . Edits and prints the tape error data from SYSREC onto SYSLST in the detail 
tape unit format. 

2. Prints the summarization of the tape data from SYSREC onto SYSLST in the 
summarized tape unit format. 


OPTION TES,SUM,VOL 


1 . Updates the TES history tape on SYS007 

2. Summarizes the tape error data on SYSREC by volume serial number. 


OPTION TES,PRINT,VOL 


1 . Updates the TES history tape on SYS007 

2. Edits and prints the tape error data from SYSREC onto SYSLST in the detail 
volume serial number format. 


OPTION TES,PRINT,SUM,SUMTAPE,VOL 


1 . Updates the TES history tape on SYS007. 

2. Edits and prints the tape error data from SYSREC onto SYSLST in the detail 
volume serial number format 

3. Summarizes the tape error data on the history tape and prints it on SYSLST 
in the summarized volume serial number format. 


OPTION TES,NOTAPE,SUM,SUMTAPE 


Summarizes the tape error data on the history file and prints it on SYSLST in the 
summarized tape unit format. 


OPTION SELECT (see note 1) 


Selectively prints records from SYSREC onto SYSLST. 


OPTION SELECT ,TAPE (see note 1) 


Selectively prints records from the history /RDE tape onto SYSLST. 


OPTION RDESUM 
(none) 


Summarizes the IPL, EOD, MCAR, CCH, and Unit Check records for a specified 
period of from one to 30 days. These records are on the history /RDE tape 
(see note 2). 

Edits and prints SYSREC onto SYSLST. 


Note 1. Records are selected by specifying select parameters. 

Note 2. RDESUM does not summarize across multiple volumes. If EOF is encountered before the entire requested reporting period 
has been covered (this can be checked through the end date printed on the RDESUM listing), rerun RDESUM using the next 
volume history /RDE file nad the same reporting period you specified during the first RDESUM execution. A listing with 
the remainder of the requested information is thus generated. 



EREP 



Table F-3-D. The EREP options 
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EREP Description of E REP Options 

EDIT 



The EDIT option causes EREP to edit and print the contents of the SYSREC ^J 1 

file on SYSLST. The unit check records are displayed first and are grouped by 
CUA (channel and unit address) within each device group (unsupported, tape, 
disk, TP, unit record, MICR/OCR). 

After the unit check records, the channel check, machine check, 2715, and 
IPL/EOD records are displayed. Retain these printouts for problem determination. 

EREP displays IBM 2715 error records from the SYSREC file in this order: 

1. Disk adapters 

2. 2790 loop adapter 

3. MPX adapters 

4. 2750 adapters. 

5. BSC adapters. 

The special code records are grouped for editing and printing by area station 
address, CUA, and special code. All area station records on SYSREC are 
summarized by device address, area station, ID, and CUA during editing and 
printing. 

EREP EDIT can execute in a 14K partition, but performance may be improved by 
allocating more than 14K (up to 42K) to the EREP partition. Storage allocation 
should be increased in blocks of 4K because the tables that EREP EDIT uses are 
each 3.5K in size. This applies only when EREP is executed in real mode. 

CLEAR: The CLEAR option causes EREP to clear (reset) the entire SYSREC file 

for RMSR recording. If the CLEAR option is specified by itself, the EDIT option 

is forced. CLEAR is always the last EREP function performed. CLEAR is forced 

if HIST, or HIST with optional parameters, is specified. / f~^ 



Note: If a hard I/O error occurs on SYSREC while the CLEA R function of EREP 
is running, EREP will abnormally end and the operator should re-IPL the system. 
In a MPS system, it may be undesirable to re-IPL. If you do not re-IPL, however, 
the contents of the SYSREC file will be unpredictable. 



^J 



c 
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SUM 

The SUM option allows hardware groups on SYSRES file to be summarized. 
This function can: 

• Accumulate certain bits and bytes in CPU logouts within MCAR/CCH 
records 

• Accumulate statistical and sense byte data from unit check records 

• Summarize area station data in 27 1 5 error records by device address, area 
station, ID, and channel and unit address. 

The SYSREC file may be summarized, or one or more hardware groups may be 
summarized. The GROUP parameter should immediately follow OPTION SUM. 



EREP 



Note: This option is only 
applicable to the Model 145. 






DISK 

DISKETTE 
TAPE 
. MICR/OCR 
GROUP= < UNITREC 
TP 
CPU 
2715 
ALL 



These entries separated by commas may be made in any order. If the GROUP 
parameter does not follow OPTION SUM or if it contains an error which the 
operator does not correct, the EREP program summaries the SYSREC file for 
the tape hardware group. 

If the SYSREC file contains records of multiple CPUs, the CPU whose records are 
to be summarized must be defined by entering 

CPU = xxxxxx,yyyy 

in which xxxxxx = the CPU serial number 
Wyy =the CPU model number. 

If no CPU is provided, records from all CPUs appearing in the SYSREC file are 
summed together. 

You can execute the SUM option more than once during an EREP run if you 
enter the option and parameter control statements via SYSLOG. After the 
summary is performed with one set of parameters, the message 

3E05A ENTER SUMMARY PARAMETERS 
is printed on SYSLOG. You may enter the parameters for another summary at 
this time, or end execution of the SUM function by responding with CANCEL 
and pressing the END or ENTER key. 

If GROUP=ALL is specified, EREP does not ask for additional parameters because 
a summary of all records is made. 

When the summary has been completed, EREP processes the next option, if any. 

It is possible to reduce the processing time for the SUM function by allocating more \ 
main storage (in blocks of 8K) to the partition in which EREP is to run. The root 
phase requires 2K and each transient 8K. The disk, tape, and unit record group use 
two transients; other hardware groups require only one transient. 

When 2715 is specified in the GROUP parameter, the 2715 records are summarized 
before any other hardware group. The 2715 group uses 10K of storage, even if 
more storage is available. If not all the 27 15 records can be processed in the 10K 
partition, those that can be are processed, after which the transient is reloaded and 
the next 2715 records are processed. This is done until all 2715 records are 
processed. 

In the 8K partition, the TP group can be process records for up to 60 distinct 
terminal names at one time. If more than 60 terminals are to be summarized, the 
file must be read more than once. If more than one hardware group is specified in a 
10K partition, the transients overlay each other and the file must be read as many 
times as there are transients. 




Note: This applies only to 
EREP executed in real mode. 
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SELECT 

By means of the specified search parameters, EREP selects records to be printed. 
The SELECT option initiates the search for these records on SYSREC; for 
example, SELECT, TAPE causes a search of the history tape to be performed. 
The parameters of the SELECT option are called select parameters; they are 
checked for validity but not for logical relationship. For example, although an 
MCAR record has no VOL field, the parameters 

TYPE=MCAR 
VOL=1 23456 

are considered valid. 

The possible select parameters are listed in the table below: 



SELECT PARAMETER 


RESULT 


CPU=xxxxxx 


All error records associated with a CPU may be selected for printing by entering the 
six digit CPU serial number. 


TYPE= -■ 


'MCAR" 

CCH 

IPL 

EOD 

TP 

UNIT 
.1275 J 


- 


A specific type of error record may be selected for printing. Any number of different 
types may be selected for each search. 


fyyddd,yyddd 
DATE= | yyddd 




All recordings made within a time span (measured in days) may be selected for printing. 
If two dates, separated by a comma, are specified, all recordings made in that time span 
are selected. If only one date is specified, all recordings made on that day are selected 
for printing. 


TIME hhmm.hhmm 


All recordings made within a time span (measured in hours and minutes) may be 
selected for printing. 


JOB=xxxxxxxx 


All recordings made during the execution of a specific job may be selected for 
printing by specifying the eight-byte jobname from the job statement. 


VOL=xxxxxx 


The error records for a specific volume may be selected for printing by entering the 
six-byte volume serial number. 


TERM=xxxxxxxx 


The error records for a terminal may be selected by entering the eight-byte terminal 
name. 


CUA=xxxx 


Records may be selected for printing by entering the channel and unit address 
(in hexadecimal) or the line number for TP. 


DEVICE=xxxxxx 


The records associated with a specific type of device may be selected by entering the 
device type code (for example, 1403, 1442N1). 


FORMAT=TES 


Whenever a tape (2400 or 3400-series) error record is encountered, it is printed in the 
detail TES format by volume serial number. If FORMAT=TES is not specified, all 
tape error records are printed in the unit check format. 


Tare a 1 
sel2715= j adapter l 

[SPECIAL J 


The 2715 records are printed in area station format if the SEL2715 parameter is not 
specified. If printing by area, adapter, or special is required, however, the SEL2715 
parameter must be specified. 



Table F-3-E. The select parameters. 



You may enter any combination of parameters; the EREP program assumes that 
you will only enter select parameters that apply to the records you want. If no 
select parameters are specified with the SELECT option, the MCAR records are 
selected and printed. 

The SELECT option can be executed more than once during an EREP run if the 
option and parameter control statements are entered via SYSLOG. After selective 
retrieval, when one set of select parameters has been completed, the message 

3E03A ENTER SELECT PARAMETERS 

is printed on SYSLOG. At this time, you may enter a new set of select parameters 
to execute the selective retrieval or you may end selective retrieval by responding 
with CANCEL and pressing the END or ENTER key. 
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RDESUM EREP 

The RDESUM option provides a summary of information about system operation 
during a specified 1 to 30 day period. This summary is created by searching the 
history/RDE tape, mounted on SYS009, for IPL, EOD, MCAR, CCH, and unit 
check records, after which these records are edited and printed on SYSLST. The 
information provided by the RDESUM option includes: 

• The starting and ending dates of the report. 

• The date, time, reason, and subsystem responsibility for each IPL. 

• The average run time between IPL and EOD (or between two consecutive IPLs 
if the ROD command was not issued to create an EOD record) for the 
specified interval. If specified, the number of IPL records that occur in the 
cluster interval, (see note) 

• The subsystem responsibility and number of times a subsystem caused a 
System Recovery Incident (a recoverable error that may cause system 
degradation) or a System Incident (an unrecoverable error that caused 
system failure). 

• If the history/RDE tape contains no records within the specified dates, an 
error message is printed and the report is terminated. 

• IPL records are not counted in the reports of sub-systems SI (System 
Recovery Incidents) 

• If an IPL record with a reason code of UN, IE, IM, ME or DF is immediately 
preceeded on the tape by an SRI that occurred within 30 minutes of the 
IPL, the SRI may be reclassified as an SI. The SRI is reclassified if (1) the 
subsystem ID specified for the IPL is the same as the device type of the SRI, 
or (2) if the subsystem ID is unknown (00). 

• Multiple SRIs on the same device are counted as a single SRI until there is a 
ten minute interval without an incident or an IPL record. 

• If an SI occurs within ten minutes of the IPL record following an SI, the SI is 
counted as a multiple occurrence of the first SI regardless of the subsystem 
involved. Intervening SRIs are ignored. 

• If 16 sequence errors occur on the history/RDE tape, RDESUM is 
terminated; if fewer than 16 sequence errors occur, the out-of-sequence 
records are ignored. 

Note: Clustering is the process of searching for multiple IPL records that have 
occurred within a specified number of minutes. Clustering can be used to detect 
multiple false starts that may distort other information provided by RDESUM. 

RDESUM is executed when the appropriate option card is encountered. The control 
information, including the start date for the report, the end date, the clustering 
interval if clustering is desired, and the company name, is entered once the 
EREPRDE phase is in main storage. The control information is entered in response 
to prompter messages. 

RDESUM does not summarize across multiple volumes of a history/RDE file. If 
EOF is encountered on the input tape, RDESUM goes to EOJ and the report 
printed reflects the information available from the start date to the last record 
on the tape. There may be some inaccuracy in the average run time per IPL 
(because RDESUM does not know when the EOD or next IPL record will occur, 
it uses the time of the last error record to compute the IPL period), but no other 
information is lost. 

RDESUM can be executed again for the next volume in the history/RDE file to 
obtain the remainder of the information for the desired reporting period. The 
previously specified period may be used on the subsequent volume because 
RDESUM starts with the first record on the tape if the specified start date is 
earlier than the date of the first record. 
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E R EP The following rules govern the method for summarizing RDE information: <, 

• If the history/RDE tape does not contain information for a portion of the 
required time period, only those dates on the tape that fall within the time 
period are processed. The actual dates processed are reflected on the 
summary listing. 

• If the starting date is defaulted, the first record on the tape is used to start 
the report. The report is stopped with the specified end date or, if that date 
is more than 30 days from the date of the first record processed, the 
thirtieth day processed. 

• If the end date is defaulted, the report is stopped with the last date on the 
tape or, if that date is more than 30 days from the starting date, on the 
thirtieth day processed. 

HIST or HIST with Operands 

This option copies the data on the SYSREC file to the history/RDE tapes. All 
records on the tape(s) appear in chronological order. If an unrecoverable I/O 
error occurs while a record is being read from the SYSREC file, the record is 
ignored and processing continues with the next sequential record. If the data fills 
the complete tape, the message 

3E15ATAPE FULL, MOUNT NEW TAPE 

is printed on SYSLOG. The operator must mount a new tape and press END to 
continue processing, or he may respond with CANCEL and press END to cancel 
the HIST option. 

The tape must be mounted on SYS009, which must be assigned to a tape drive 

before EREP is executed. The tape contains standard labels that are checked / r 

before the history/RDE tape is written. If the wrong tape is mounted, the message [ 

3E31A WRONG TAPE, MOUNT CORRECT TAPE 

is printed on SYSLOG, Mount the correct tape and press END to continue 
processing, or respond CANCEL END to cancel the HIST option. When the HIST 
option is specified, the CLEAR option is forced. The SYSREC file is cleared 
after the history/RDE tape has been created or updated, thus preventing 
redundant data from being transferred to the history/RDE tape the next time the 
HIST option is executed. 

HIST,NEW,[,2] : This option causes EREP to create a history file on the tape unit 
assigned to SYS009. If 2 is also specified, a second history file is created on the 
same tape unit for RDE data. The data contained on both tapes is identical. The 
tape(s) contain the contents of the SYSREC file. The SYSREC file is cleared after 
all options have been executed. 

HIST.UPNEW: This option causes the tape file mounted on SYS009 (either 
history or RDE) to be updated, after which a new tape file is created. If UPNEW 
is specified, TLBL information for creation and updating must be included in the 
job stream. The SYSREC file is cleared when all options have been executed. 
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The TES options provide for the editing and printing of the tape error records on 
SYSREC and the summarizing of tape data found on either SYSREC or the history 
file. 

To enable this option to be used a work or scratch tape must be mounted on a tape 
unit assigned to SYS008. This option can also select tape error data from the 
SYSREC file and create a TES history tape with the same format as the previously 
supported ESTV tape file. All records on the tape appear in chronological order. If 
an unrecoverable I/O error occurs while reading a record from the SYSREC file, 
the record is ignored and processing continues with the next sequential record. If 
the data fills the complete tape, the message 

3E15A TAPE FULL, MOUNT NEW TAPE 

is printed on SYSLOG. The operator must mount a new tape and press END, or he 
may respond CANCEL END; the latter response causes tape updating to be 
discontinued, but TES records are still printed. 

The tape must be mounted on SYS009, which must be assigned to a tape drive 
before EREP is executed. The tape contains standard labels that are checked 
before the history/RDE tape is written. If the wrong tape is mounted, the message 

3E31A WRONG TAPE, MOUNT CORRECT TAPE 

is printed on SYSLOG. Mount the correct tape and press END to continue processing 
or respond CANCEL END to cancel the TES option. The history/RDE tape and 
TES history tape should be created or updated during the same EREP run. If the 
HIST option is specified without the TES option, the SYSREC File is cleared after 
HIST has been executed, and the TES data is lost. If you wish to maintain both 
these history tapes and the TES and HIST options are not specified together in 
one EREP run, the data on the TES history file may be redundant or lost. 

TES, NEW: This causes EREP to create a TES history file on the tape unit 

assigned to SYS007. The tape file contains tape error data from the SYSREC file. 

The tape error data on the tape has the same record format as the previously 

supported ESTV tape file. Use ESTVUT utility program to print this tape file. 

TES: EREP updates the TES history tape on SYS007. 

TES,NOTAPE,PRINT: Causes the tape data on SYSREC to be edited and printed 

into SYSLST. Data is printed in the detail tape unit format. 

TES,PRINT,NEW: A new TES history tape is created on SYS007, after which the 

tape error data on SYSREC is edited and printed on SYSLST. The data is printed 

in the detail tape unit format. 

TES,PRINT: The TES history tape, which is mounted on SYS007, is updated. 

The tape error data on SYSREC is then edited and printed on SYSLST in the 

detail tape unit format. 

TES,NOTAPE,SUM: The tape error data on SYSREC is summarized by tape drive. 

TES,NOTAPE,PRINT,SUM: The tape error data on SYSREC is edited and printed 

on SYSLST in the detail tape unit format. Then the tape error data on SYSREC is 

summarized by channel and unit and printed on SYSLST. 

TES,SUM,VOL: The TES history tape on SYS007 is updated. Afterwards the 

tape error data found on SYSREC is summarized by volume serial number. 

TES,PRINT,VOL: The TES history tape mounted on SYS007 is updated. The 

tape error data on SYSREC is edited and printed on SYSLST in the detail volume 

serial number format. SYS008 is used as a work tape and the detail records are 

printed in sequence by volume serial number. 

Four examples of processing tape error statistics using EREP are given in 
Appendix 0. 
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Y 
There are three types of EREP history tapes: the History tape, the RDE tape, and 
the TES history tape. The History and RDE tapes are created and updated from the 
SYSREC file and contain all the record types found on the SYSREC file. The TES 
history tape is also created from the SYSREC file, but contains only tape error 
records. If your installation has the History/RDE tapes and a TES history tape, you 
should create (or update) all the history tapes in the same run. If this procedure is 
not followed, the TES history tape may have redundant or missing data. 

Retain the History and TES history tapes for those persons who work on problem 
determination. The History tape can be used as input for certain online test 
programs of OLTEP. (See the OLTEP manual.) The TES history tape can be printed 
with the ESTVUT utility program. Retain the RDE tape; it will be used by IBM. 



History/RDE Tape 

The History/RDE tape is created and updated using the EREP history option. This 
tape contains RDE data only if ERRLOG=RDE is specified at system generation. A 
magnetic tape unit assigned to SYS007 must be used for this function. EREPNEW 
must be the filename that is used when a tape is created, and EREPUP when a tape 
is updated (both TLBL cards must be included for UPNEW). When the tape becomes 
full or when a second tape must be mounted, the operator is notified via SYSLOG. 

Note: If EREP is link-edited as a self-relocating program, an LBLTYP card is 
needed when EREP builds a history /RDE tape. 

TES History Tape 

The TES history tape is created and updated using the EREP TES options. A 
magnetic tape unit assigned to SYS007 must be used for this function. The filename 
of the tape file must be TAPEIN when the file is created and the file is updated. 



Creating the History Tapes 

You can create a history tape only if DOS/VS has recorded errors on SYSREC. 
The EREP program allows you to create or update the three types of history tapes, 
three types of history tapes. 

You can create the History/RDE tape by specifying OPTION HIST, NEW, and 
update it by specifying OPTION HIST. 

If a System/370 RDE tape is to be processed, the message 3E16A is printed on 
SYSLOG after the History tape is written. This message instructs you to replace 
the History tape reel with the RDE tape reel and then respond to the message. A 
response of END will cause the RDE tape to be processed and response of CANCEL 
END will cancel only the HIST option. Any other response will cause the system 
to reissue message 3E16A. 

In addition, you can create a TES history tape, which contains only tape error 
records. If you want to maintain a TES history tape, create (or update) it in the 
same EREP run in which you create (or update) the History/RDE tape. You can 
create the TES history tape by specifying OPTION TES,TAPE,NEW, and update 
it by specifying OPTION TES, TAPE. 



4T> 
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Processing the tape error statistics with EREP 

The EREP (Environmental Recording, Editing, and Printing) program provides 
processing options for the tape error statistics records on SYSREC. 

Tape records can be edited and printed or summarized, together with the order 
records on SYSREC; you may also choose to have only the tape error records of 
the file selected or summarized. If the SYSREC file has been used to create a 
history/RDE tape, the records on that tape contain the same information as the 
SYSREC file contained. In this case the tape error statistics records can be selected 
or summarized from the history/RDE tape file. 

The SYSREC file may also be used to create a TES history tape. This tape contains 
tape error statistics records only. These records have the same format as the 
records of the former ESTV disk file; thus only part of the information recorded 
on the SYSREC file for tape error statistics is written on the TES history file. The 
information written on the TES history file consists of: 

Date the record was collected 

Physical address of the device on which the tape volume was mounted 

Number of temporary read errors 

Number of temporary write errors 

Number of permanent read errors 

Number of permanent write errors 

Number of error gaps encountered 

Number of noise blocks encountered 

Number of cleaner actions taken 

Number of SIO instructions issued 

Volume serial number if the tape was a standard labeled volume 

Block length if the volume contained fixed-length blocked records 

Tape density of the tape volume. 
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The history /RDE tape and the TES history tape must always be updated in the 
same run. Failure to update both these tapes on the same run may result in 
redundant or lost data on the TES history tape. When PRINT is specified, the 
detail records on SYSREC are printed on SYSLST. When SUM is specified, the 
tape error statistics are summarized on either the history tape or SYSREC. 

It is possible to print or summarize tape error statistics by volume serial number 
or by tape drive address. 

When tape error statistics are summarized by volume serial number, it may be 
possible to reduce processing time by allocating more main storage to the EREP 
partition. Approximately 90 distinct volumes can be summarized in a 10K 
partition. When the SYSREC file contains recordings for more than 90 distinct 
volumes and EREP is run in a 1 OK partition, the SYSREC file is read and 90 volumes 
are summarized; then the SYSREC file is processed again and the remaining (or 
next 90) volumes are summarized. 

If you want to reduce processing time when there are more than 90 volumes, 
therefore, you must allocate enough storage, thus allowing all volumes to be 
summarized on only one read -through of the SYSREC file. Approximately 12 
additional volumes can be processed for each IK added to the partition. To 
calculate the number of volumes that can be summarized in a particular partition, 
use the following formula: 



o 



J 



80 bytes 
P - if tape is - 2740 
assigned 

N = 

82 
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Processing the TES H istory Tape with the ESTVUT Utility Program E R EP 

When a TES history tape is created from the data on SYSREC, ESTVUT (the 
ESTV Dump File Program) is used to process the data on the TES history tape. 
This utility program dumps the TES history file on SYSLST. 

ESTVUT consist of one module that has to be cataloged in the core image library. 
The module name to be used in the INCLUDE statement for this routine is 
IJBTESUT. 

Control Cards necessary to run ESTVUT. 

ESTVUT can be executed either from a card reader or from SYSLOG. An example 

of the job control statements required for ESTVUT is: 

//JOB ESTV DUMP 

//ASSGNSYS005,X"I8T 

// ASSGN SYSLST,X'00E' 

//TLBLTAPEIN 

// LBLTYPTAPE 

// EXEC ESTVUT 

/* 

/& 

Symbolic Unit Assignments: Every sumbolic unit required for execution of the 
ESTVUT program must be assigned either temporarily for one job, or permanently. 

• SYS005 must be assigned to the magnetic tape unit on which the TES 
history file is mounted. 

• SYSLOG must be assigned to a 3210, a 3215 or a Model 125 video display 
unit for all executions of ESTVUT in order to log inquiries and accept replies. 

Label information: Label information must be available to the system whenever 
the devices are used in the execution of ESTVUT 

• The first operand of the TLBL statement for the input tape must be 
TAPEIN 

• A LBLTYP for tape is required if the program uses tape and has been 
cataloged as a self-relocating program (+0 on the PHASE card). This 
statement reserves space for processing standard label information. 

Contents and format of printed output 

When the operator specifies a printer as the output device, the collected error 
statistics are formatted and printed as illustrated below: 




VOLUME 




TIME 


CHANNEL 


TEMP 


TEMP 


PERM 


SERIAL 


DATE 


OF DAY 


/UNIT 


READ 


WRITE 


READ 


xxxxxx 


yr/day 


hr.mn.sc. 


cuu 


nnn 


nnn 


nnn 


PERM 


NOISE 


ERASE 


CLEANER 


SIOS 


TAPE 


BLOCK 


WRITE 


BLOCKS 


GAPS 


ACTIONS 


USAGE 


DENSITY 


LENGTH 


nnn 


nnn 


nnn 


nnn 


nnnn 


nnn 


nnnn 



Each page of output contains 50 lines of data. 

On the last page, a message is printed below the last line of data. The message is: 
ESTV TAPE FILE DUMPED 
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Execute the EREP program at the request of the customer engineer or in response 

to an instruction in an error message. The operator commands necessary to £^\ 

execute EREP through either SYSLOG or SYSRDR are: \^ 

PAUSE BG,EOJ 

//TLBL EREPNEW (see note 1) 

// EREPUP 

//TLBL TAPEIN (see note 2) 

TESUP 
//ASSGN SYS007,X'cuu' 
//ASSGN SYS008,X'cuu' (see note 3) 

// LBLTYP TAPE 
//EXEC EREP 

Note 1: This card is necessary only if you want to create or update either a 

history tape or a history tape and a Model 145 RDE tape. Use EREPNEW when 

creating and EREPUP when updating. 

Note 2: This card is necessary only if you are creating or updating the TES 

history tape. Use TAPEIN when creating and TESUP when updating. 

Note 3: This control card is necessary if you are updating or creating any of the 

history tapes (History tape, RDE tape, or TES history tape). 

Then EREP issues a message to the operator via SYSLOG or SYSIPT that is to be 
used for entering the EREP options. 

3E1ID ENTER OPTION SOURCE ,C=CARD, 
S=CONSOLE,N=NONE 

The operator must respond with one of the following: 

• C followed by END for SYSIPT 

• S followed by END for SYSLOG 

• N followed by END for the default option, EDIT. 4~~\ 

The default will be N END or just END, and the result will be the editing and \*J 1 ' 

printing of the SYSREC file. If the operator response is C END or S END, the 
system awaits option data on either SYSIPT or SYSLOG. Enter CANCEL END 
if you wish to cancel the job at this time. 

If any response other than C, S, N, CANCEL, or END is entered: 

3E25I INVALID RESPONSE 
will appear on SYSLOG and message 3E1ID is reissued. 

Entering EREP options 

EREP options can be entered through SYSLOG or through SYSIPT. 

If you use the console printer-keyboard for input, you respond to the prompter 
messages. 

There can only be one option per line (SYLOG entry) or one option per card (card 
entry). Only one option card for each type of option (EDIT, CLEAR, SUM, HIST, 
TES, and SELECT) may be entered in an EREP run. However, when entered via 
SYSLOG, the SUM and SELECT options may be executed more than once in a 
single EREP run. Table F-3 lists the EREP options. 

You can alter the order of EREP actions by specifying two options. For example: 

OPTION EDIT Edit and print the SYSREC file. 

OPTION HIST Update the history tape, and then clear the file. 

*The END key on the Model 125 is replaced by the ENTER key 
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Job stream via 
SYSRDR 




3E11D ENTER OPTION SOURCE, C=CARD, 
S=CONSOLE, N=NONE 



When RMS=NO 

Run EREP only when hardware 
failures are detected on channel 
attached input/output devices, 
magnetic tape units and TP. 
Use MAINTENANCE LOG 
ANALYSIS to display hardware 
failures. F-5-F. 



Enter C 
Press End 



Select option 
Enter S 
Press End 



Enter N 
Press End 




System waits for EREP options 
to be entered, for details see F-5 







Options entered 
via SYSIPT 




Options entered 
via SYS LOG 




Default option EDIT 

selected. 

Refer to table F-3-D 



Yes 



Refer to table F-3-A 



Yes 



3E05A ENTER SUMMARY PARAMETERS 
Refer to table F-3-B 



Yes 



3E03A ENTER SELECT PARAMETERS 
Refer to table F-3-E. 



Option EDIT, CLEAR, 
RDESUM, or HIST. 
Refer to table F-3-D 
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E R EP For input from either SYSIPT or SYSLOG, embedded blanks within the operation, 

option, or parameter are not allowed. Misspelled words, syntax errors, duplicate 
option statements and unsupported options are invalid. 

When input is from SYSIPT, these errors will cause 40 bytes of the card to be 
issued to SYSLOG along with the message: 

3E04I INVALID PARAMETER 

or 

3E12D INVALID OPTION 

At this time, you may place a corrected card in SYSIPT and then press END to 
process the desired option. If you do not want to process the card in error, enter 
END and the program will ignore that option card. However, if you wish to cancel 
the job, enter CANCEL END and the EREP job will be canceled. Multiple options 
are allowed by EREP. See figure F-3-D for a summary of the EREP options. 

Entering options via SYSLOG: When the EREP options are entered via SYSLOG, 
it is possible to execute the SUM and SELECT options more than once during an 
EREP run. After the SUM or SELECT function has executed, the message 

3E03A ENTER SELECT PARAMETERS 

or 

3E05A ENTER SUMMARY PARAMETERS 

is issued to SYSLOG. You may execute the SUM or SELECT function again by 
entering parameters at this time. If you wish to terminate the SUM or SELECT 
option, press END. '\-J^' 

When entering the EREP option via SYSLOG, the entry must not exceed 80 
positions. Enter, in this sequence: 

1. The operation, OPTION 

2. A blank 

3. The option. 

Any parameters should follow the OPTION statement on the next line(s). Repeat 
this procedure for each option; when all options have been specified, enter END to 
continue processing. 

Note: The END key on the Mode! 125 is replaced by the ENTER key. 



c 
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Entering options via SYSIPT: When entering the EREP options via SYSIPT, EREP 

column 1 must be blank and only one option per card is allowed (for example, 
HIST with UPNEW or with NEW and/or 2 is considered one option). Each option 
may only be entered once for each execution of the EREP program. 

Example job streams for executing EREP: 

//JOB EXAMPLE1 

//TLBL EREPNEW 

//TLBLTAPEIN 

// ASSGN SYS007,X'cuu' 

// ASSGN SYS008,X'cuu' 

// ASSGN SYS009,X'cuu' 

// LBLTYP TAPE 

//EXEC EREP 

OPTION HIST, NEW 
OPTION TES,TAPE,NEW 

/* 

/& 

// JOB EXAMPLE2 

//TLBLTESUP 

//TLBL EREPUP 

// ASSGN SYS007,X'cuu' 

// ASSGN SYS008,X'cuu' 

// ASSGN SYS009,X'cuu' 

// LBLTYP TAPE 

// EXEC EREP 
OPTION EDIT 
OPTION TESTAPE 
OPTION HIST 

/* 

/& 
EREPNEW and EREPUP must be the filenames for new history files or for 
updating. TAPEIN and TESUP must be the file names for a new TES history tape 
or an update TES history tape. 




Serviceability Aids. 2.223 



Hardware Error Recording and Recovery 

EREP 







An example of an EREP output obtained after a storage failure. 

The programmer's marks indicate the areas of interest. 

Note: the entry CONTROL WORD ADDRESS is not applicable for the Model 125. 
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When to use E REP EREP 

Your IBM customer engineer will usually advise you when an EREP printout is 
required, and tell you which option to select. 

Under certain hardware failure conditions, a message issued on SYSLOG, for 
example, message 0T1 1W in the DOS /VS Messages manual will request you to 
RUN EREP. 

Other DOS/VS messages that request you to RUN EREP are issued, for example, 
in the following cases: 

• When the first record on the last track of the recorder file is reached, run 
EREP to avoid the risk of losing statistics. 

• When an unrecoverable I/O error on the recorder file occurs while the 
record indicated is being accessed, the record is ignored and processing 
continues. If this error persists, run EREP to retrieve the information from 
the file and recreate the file using different disk extents. 

• When SYSREC becomes full, no further recording occurs until the file is 
purged. To avoid the risk of losing statistics, run EREP. No recycling of the 
file occurs. 

• For system termination situations (for example, a machine check was 
unrecoverable, the channel caused system reset, or two channels are 
damaged) encountered by MCAR/CCH, recording is attempted. Depending 
on the success of recording, the execution of EREP is requested. An attempt 
is made to write a message to the operator. If the attempt is unsuccessful, 
the message code is in low main storage. 

• If the recorder file is more than 90% full at IPL time, the operator is requested 
to run EREP to prevent the loss of pertinent hardware data. 

Another occasion when you may choose to execute the EREP program is when you 
suspect that a hardware error is causing program errors. From the EREP printout 
you are able to detect any hardware failure and inform your IBM customer 
engineer of it. 




If 
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SEREP 

(MODEL 135, 145 or 155-11! 



SEREP is a self-loading, stand-alone program used to: 

1. Write the logout from real storage to some storage device such as tape for later 
use by the IBM CE 

2. Perform a hard-copy Edit/Print of the logout. 



When to use 

SEREP is primarily an aid provided for the IBM CE to help his offline diagnosis 
of hardware failures. For this reason SEREP need only be executed on the advice 
of the IBM CE or when requested to do so by a message on SYSLOG, or when a hard 
wait occurs and byte 1 of low real storage contains S (X'E2'). 

Flowcharts in Section 3 indicate when to use SEREP during IPL errors or if the 
system enters a hard wait state. 

Not applicable to the Models 115 and 125. 
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Start 



Before executing ensure 
that there is no system 
activity. 




Yes 



Press 

SYSTEM RESET 



1 



See next page 



Set CHECK CONTROL to 
STOP AFTER LOG 



Press START and wait 
until CPU stops 




Yes 



Punch 3-character address 
(for example, '00D') of re- 
quired output device in cols. 
67, 68, and 69 of last TXT 
card (next to last card in 
SEREPdeck) 



X 



Enter SEREPdeck 

into card reader and load 

SEREP using IPL procedure 



Yes 




To retry, press RESTART 



T 



When edit is complete, 
write date and time on first 
page of logout 



Re-IPLif job 
processing is 
to be attempted. 






The procedure for executing the SEREP program. 



SEREP 
[MODEL 135, 145 or 155-11) 



Wait state while executing SEREP 

Normal Waits 

When no output device is specified, or the specified device 
is not ready, the system enters the wait state after loading 
SEREP 

Hard Waits 

An unexpected program check during execution of SEREP 
causes a message to be printed, and the system enters the 
wait state. Retry is attempted by pressing RESTART. Re- 
IPL should be avoided because alteration of PSWs by the 
SEREP program may cause that edit to be erroneous. 

Termination 

When logout is complete, a message is issued and the system 
enters the wait state. If no log is found, a message is issued 
and the system enters the wait state 



F-4-F 



Avoid new IPL procedure. Because SEREP 
might have altered its PSW by this time, a 
re-IPL can cause part of edit to be wrong 

The only possible operator intervention that 
may be required would be for mounting the 
accumulation tape when the program asks for it. 
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SEREP 
(MODEL 158) 



Unlike the Models 135, 145, and 155-11, the Model 158 has no CPU logout area 
in real storage. Instead of being recorded in that area, certain types of hardware 
errors are recorded on the Log Recording Console File. The SEREP program also 
resides on the console file and can be loaded through its own IMPL procedure by 
using the MANUAL, SERVICE and INDEX frames. When SEREP is loaded, the 
SEREP frame is displayed to enable you to select one of the options. The options 
include: 

• Write the log to tape 

• Edit and print the log 

• Select and process one of eight previous logs. 

How to execute (Edit and print option) 

1 . Press STOP followed by MODE SEL 
The manual frame will be displayed 

2. Type in F2 or press light pen to lozenge ■ SERVICE FRAME 

(If a "hard copy" of the service frame is required on the 3213 printer, press 
COPY key or press light pen to lozenge ■ COPY) 
The service frame will be displayed. 

3. Type in F4 or press light pen to lozenge ■ 4-INDEX FRAME 
The index frame will be displayed as shown below. 

(Using COPY will not generate a hard copy of this frame.) 



Kv*r 



7-CTRL STORE DISPLAY 
8-COMMON CH DISPLAY 



9-CHANIMEL DISPLAY 
10-CHANIMEL 1 DISPLAY 



11-CHANNEL 2 DISPLAY 
12-CHANNEL 3 DISPLAY 



13-CHANNEL 4 DISPLAY 
14-CHANNEL 5 DISPLAY 



15-SCU DATA FLOW1 
16-SCU DATA FLOW2 



17-CHANNEL TO CHANNEL 
18-EXECUTION ARRAY 



20-CSBAR BKUPS 



COMPOSE- "START "STOP "CLEAR 



21-CPU CHECKS&RETRY 



23-CHAIMNEL CHECKS1 



28-EXTERNAL DIAGNOSTICS 



,>' 
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How to execute . . . continued 

4. Type in F28 or press light pen to lozenge 

■ 28-EXTERNAL DIAGNOSTICS 
The frame shown below will be displayed. 
( Using COPY will not generate a hard copy of this frame.) 
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(MODEL 158) 



i FIRE THIS LOZENGE TO LOAD AND EXECUTE SEREP 



l TO PROCESS A PREVIOUS LOG I 



=!E THIS LOZENGE UNTIL - TRACK SELECTED 



DESIRED LOG (MO. IS DISPLAYED HERE = XX 
THEN SELECT AND LOAD SEREP (ABOVE) - 



TO SELECT ABOVE OPTIONS WITH KBD-PRESS REQUEST, POSITION ARROW, PRESS ENTER 



SERVICE FRAME INDEX 







5. Press light pen to the lower lozenge until number 08 is displayed at the 
position of the two XX in the example shown above. 

6. Press light pen to upper lozenge on the display 
The program frame will be displayed. 

7. Press REQ key 

8. Respond to messages displayed as shown in the hard copy example below. 



158 SEREP, MACHINE CHECK SUMMARY DESIRED? REPLY YES OR NO 



MACHINE CHECK SUMMARY: 



READY FOR LOG DUMP TO TAPE PORTION OF PROGRAM 
REPLY PROCEED OR CANCEL 



READY FOR EDIT/PRINT OF LOGOUT 
REPLY PROCEED OR CANCEL 



ENTER PRINTER ADR XXX 



END OF SEREP EXECUTION 



(The operators responses are shown in lower case characters.) 

The SEREP frame will be "rolled" onto the display as responses are given. After 

the address of the printer to be used as output device is entered, SEREP output 

will be observed on that printer. 

Note: The output device can be a tape unit, or the console printer. 
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LOG ANALYSIS 
(MODELS 115 AND 125) 



The LOG ANALYSIS facility allows the operator to display statistical data about 
hardware failures that are logged on the DISKETTE. 

The type and amount of detail displayed is selected by entering appropriate 
mnemonics into the MAINTENANCE PROGRAM SELECTION display. The 
sequence of displays is designed to guide the operator from the initial type of 
display selected to displays that provide more detailed data. 

For an interpretation of the data displayed refer to the Central Test Manual. 

The example shown on the opposite page illustrates the sequence of displays 
obtained to display the errors logged by the IPU (Instruction Processor Unit). 



1 i) 



When to use 

Your IBM customer engineer will usually advise you when to use this feature, and 
tell you which display to select. He may require a hard copy for offline analysis 
of all the displays selected, therefore save the hard copy output. 

Under certain hardware failure conditions, a message issued on SYSLOG, for 
example, message .0T1 1W in the DOS/ VS Messages manual will request you 
to RUN EREP. 

For the Models 115 and 125 you should only run EREP when requested to by a 
DOS/VS message. For example when the recorder file is full a message will be 
displayed informing you of this and re questing you to run EREP. Otherwise, before 
running EREP you should first contact your IBM customer engineer, who will then 
advise you on further action as mentioned in the previous paragraph. 



How to use 

To obtain the LOG ANALYSIS display required using fast selection, 

1 . Press the MODE SELECT key. 

2. Type in M followed by the associated mnenorriics of the analysis to be displayed. 

3. Press the ENTER key. 

By selecting and entering the appropriate mnenomics, the operator can display 
logged errors for a particular input/output device or a particular part of the CPU. 



U J 
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Press MODE SELECT 



LOG ANALYSIS 
[MODELS 115 AND 125) 



MODE SELECTION 



R SYSTEM RESET 

C ADDRESS COMPARE 

. PROGRAM LOAD 

i" INTERVAL TIMER 

K CHECK-CONTROL 

D STORAGE DUMP 

E ICA LINE MODES 
MODE SPECIFICATION: 



A ALTER/DISPLAY 

I INSTRUCTION STEP 

P RESTART 

M MAINTENANCE 

S STORE STATUS 

U SAVE USAGE COUNTERS 



Enter M and press ENTER 



MAINTENANCE PROGRAM SELECTION 



A= LOG GENERAL 

B = CPU 

C = CARD/PRINT I/O 

D= DISK 

E = ICA 

I = CHANG. DISKETTE 



J =CPU 
K = 1403 
L = 2560/5425 
M = 3504/3525 
N = DISK 
0=ICA 



CE-MAN.CPS 

S =IOP 

U = CRT-SCOPE 

V = l/OEXERS 
X = IPU 

Y = MATRIX S 
Z = MATRIX M 



PROGRAM SELECTION: M R = SYSTEM TEST (ASCP) 






Enter B and press ENTER 




CPU LOG ANALYSIS PROGRAMS 



= SVP BUS-0 LOG 

C = IPU ANALYSIS I 

D = IPU LOG DISPLAY | 

E = MSC ANALYSIS | 

F = MSC LOG DISPLAY i 

G = IOP 8-F ANALYSIS 

H = IOP 8-F LOG DISPLAY 

PROGRAM SELECTION: MB 

):C003 M:X.DA00.4C. 



K = MTA LOG DISPLAY 

L = MSCI LOG ANALYSIS 

M = MSCI LOG DISPLAY 

N = MPX ANALYSIS 

O = MPX LOG DISPLAY 



Enter C and press ENTER 



CARD/PRINT I/O LOG DISPLAY PROGRAMS 



B= 3504 LOG DISPLAY H= 5425 LOG DISPLAY 



D= 3525 LOG DISPLAY K= 1403 LOG DISPLAY 



F= 2560 LOG DISPLAY M= 5203 LOG DISPLAY 



PROGRAM SELECTION: MC 



o 



Displaying the IPU Log Analysis 
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Hardware Error Recording and Recovery 



DISPLAY FRAMES 
(MODEL 158 ONLY) 



This facility enables an operator to display information about hardware failures and 
warn the shift manager of IBM CE immediately about the nature and possible cause 
of the failure. 

Recognizing a hardware failure 

A hardware failure is indicated by a message which 'flashes' on and off at the lower 
right hand corner of the program frame or manual. 

The example below shows a hardware failure indicated by the words STOR CHECK 
on the manual frame. 




After recognizing the failure an operator is able to 'scan' the display frames and thus 
obtain detailed information about the condition of the hardware. This information 
may enable the IBM CE to diagnose the failure immediately and advise on continued 
system operation. He may also advise that the SEREP is executed and request 'hard 
copies' of the display frame on which the failure is indicated to enable an offline 
diagnosis of the failure. 






How to use 

From the program frame: 

1. Press MODE SEL 

The manual frame is displayed 

2. Type in F2, or press light pen to lozenge ■ SERVICE FRAME 
The service frame will be displayed 

3. Type in F4, or press light pen to lozenge ■ INDEX FRAME 

The index frame will be displayed, an example of which is shown in Section 1. 

4. Press light pen to lozenge - CPU DISPLAY 

The first display frame will be displayed, an example of which is shown at the 
top of the opposite page. 
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Hardware Error Recording and Recovery 

DISPLAY FRAMES 
(MODEL 158 ONLY) 





5. Scan the frame for any characters that flash on and off beside an entry displayed. 
For example, Z-BUS 614250 indicates that the hardware failure is caused by a 
failure in the Z-BUS. 

If a hardware failure is indicated, press COPY to obtain a hard copy of that 
frame and make a note on the hard copy about the error. (Characters that 
indicate an error are not copied by the system.) 

6. Press the key marked f on the keyboard, as illustrated below. 
The next display frame will be displayed. 



CNCL 


1 


< 

2 


3 


4 


% 
5 


t 

6 


> 

7 


8 


( 
9 


) 



+ 
& 


< 


START 


STOP 




H 


Q 


W 


E 


R 


T 


Y 


U. 


I 





p 


@ 


\ 




MODE 
SEL 


IRPT 




REQ 


LOCK 


A 


S 


D 


F 


G 


H 


J 


K L 


! 




, t 


t 


1 


3 




1 






COPY 


SHIFT 


Z 


X 


C 


V 


B 


N 


M 


, 


1 


? 

/ 


SHIFT 












KEYBD 
RESET 








ENTER 







7 . Repeat steps 5 and 6 until all display frames have been scanned and hard copies 
made of those containing information about the failure. 

8. Press CANL to obtain the program frame. 



When to use 

1. After recognizing a hardware failure as shown in the example above. 

2. On advice from your IBM CE. 
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Hardware Error Recording and Recovery 
OLTEP 






IBM provides a set of device test programs that run under control of DOS/VS. 
These test programs and the online test executive program form the online test 
system. The Online Test Executive program (OLTEP) is an interface between the 
system and the online test programs (OLTs) and communicates with the operator 
during the running of tests. 

Some uses: 

• Diagnosing I/O errors 

• Verifying I/O device repairs and engineering changes 

• Checking I/O devices. 



Note: Not applicable to the 
Models 115 and 125 using 
a supervisor that does 
not support the RMSR 
function. 



Some features: 


• 


Multiple device testing 


• 


Data security 


• 


Data protection 


• 


No re-IPL time required 


• 


Prompting 


• 


ASCII data conversion 


• 


Accessing of error recording information 


• 


CDS Equate function. 



OLT 



OLTEP 



Printer 



OPERATOR 



Supervisor 



Card 
Read/Punch 




■SK 



Teleprocessing 




OLTEP-System Relationship 



/O 
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Hardware Error Recording and Recovery 

Description and Operation OLTEP 

OLTEP operates much like other problem programs in DOS/VS. It is cataloged into 
the core image library and called by standard job control statements. When OLTEP 
is called, it notifies the operator that it is active and it communicates with him 
during testing. OLTEP can run in a batch-only system or as a background program 
in a multiprogramming environment. OLTEP must be run in the background 
partition in real mode and requires at least 14K. 

You can test an I/O unit with minimum interference to other programs running 
on the system. Testing an I/O device ordinarily does not interfere with system 
input and output. Any unit being tested (except for direct access devices) must not 
be assigned to the foreground partitions. Direct access devices, however, may be 
shared. 

An OLTEP user language defines and controls the test. With this language, you 
select the devices to test, the test sections to run, and the options to exercise. You 
enter this information via the console device or in the form of a control statement 
in the job input stream. This information is referred to as the test-run definition, 
which is common to OLTEP components for all operating systems. 

You can test multiple devices of the same type with no operator interventions 
other than those required for data protection and data security. OLTEP loads and 
executes the test sections one at a time until all the tests for one device are 
completed. If requested, the test sections then repeat for the next available device. 
Testing continues in this manner until all units in the test-run definition are tested. 

During testing under control of OLTEP, the system error recovery procedures are 
bypassed for the device being tested. OLTEP has built-in data integrity safeguards 
so that no data is destroyed without operator permission, and no protected data 
is accessed during testing. 
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DOS/VS Serviceability Aids and Debugging Procedures 

SECTION 3 



DEBUGGING FOR THE 
OPERATOR 



3.1 
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Section 3 



DEBUGGING 
PROCEDURES 
FOR OPERATORS 



How to Use 

This section is in the form of flowcharts that help the operator in the initial 
isolation of and possible recovery from errors that occur during system operation. 

• Each flowchart deals with a specific type of malfunction. 

• Pointers to operator's flowcharts in Section 2 (that must be followed to 
complete a procedure in this section) are referenced by the page tabs 
used in Section 2. 

For example: 



Execute a stand 
alone dump 
A-3-F 



Key to references: 



X-X-F 



Page tab 
of Section 2 

Flowchart 






• When immediate recovery is not possible, offline program debugging is 
indicated. 



Operator's Flowcharts 

Error during IPL 
Initial system checks 
System in WAIT STATE 
Unintended LOOP 
Obviously incorrect output 
Job canceled by system 



Chart 01, parts 1 through 9 3.5 

Chart 02 3.15 

Chart 03, parts 1 through 4 3.16 

Chart 04, parts 1 through 6 3.22 

Chart 05... 3.28 

Chart 06 3.29 



3.2 Debugging for Operators. 



Section 3 

WAIT STATE CODES 






BYTEO 


BYTE 1 


BYTE 2 


BYTE 3* 


EXPLANATION 


IPL Error Messages placed in Low Address Storage 


X'FO' 


X'C9' 


X'FO' 


X'FO' 


This code indicates that less than 16K of real storage is left for problem programs. Check 
that the correct disk volume is mounted on the device assigned to SYSRES, and re-IPL. 
If the error recurs, the system programmer must check the allocations of real partitions 
specified in the supervisor to be used, and check that at least 16K of real storage is 
available for execution of problem programs running in virtual mode. 


X'FO' 


X'C9' 


X'FO' 


X'FV 


If a card reader has been assigned to SYSRDR during system generation and is to be the IPL 
communication device, press the INTERRUPT key. 

If a card reader has not been assigned to SYSRDR during system generation and yet it is 
to be the IPL communication device, simply READY the reader. 


X'FO' 


X'C9' 


X'FO' 


X'F2' 


This code means that the supervisor requested cannot be found. 

Check that the correct disk volume is mounted on the device assigned to SYSRES. If it is 
correct, re-IPL and specify a different supervisor when message 0I03A is issued and press the 
END/ENTER key, or press END/ENTER key only, to load the standard supervisor. (If 
possible contact the system programmer and check which supervisor to use.) 


X'FO' 


X'C9' 


X'FV 
X'F2' 


X'FO' 
X'F8' 


Refer to messages 01 100A - 0128A in DOSA/S Messages. 


MCH/CCH/IPL Hard Wait Codes placed in low address storage 


X'CV 
X'C2' 
X'C3' 
X'C4' 
X*C5' 
X'C6' 

X'C7' 
X'C8' 
X'C9' 
X'DT 
X'07' 


X'E2'(2) 
X'E2'(2) 
X'E2'(2) 
X'E2'(2) 
X'E2'(2) 
X'E2'(2) 

X'E2'(2) 
X'E2'(2) 
X'E2'(2) 
X'E2'(2) 
X'E6' 


A, I, SO) 
Not used 
A, I, SO) 
A, I, SO) 
A, I, SO) 
A, I, SO) 

A, I, SO) 
A, I, SO) 
A, I, SO) 
A, l # SO) 
Channel 


Not used 
Not used 
Not used 
Not used 
Not used 
Not used 

Not used 
Not used 
Not used 
Not used 
Unit or 
X'OO' 


Irrecoverable machine check. 

Irrecoverable channel failure during RMS fetch. 

Channel failure on SYSLOG when RMS message scheduled. 

No ECSW stored. 

Channel failure: ERPBs exhausted. 

Channel failure; two channels damaged or a damaged channel situation occurred while RMS 

was executing an I/O operation. 

Channel failure; system reset was presented by a channel. 

Channel failure; system codes in ECSW are invalid. 

Channel failure; channel address invalid. 

Irrecoverable channel failure on SYSVIS. 

IPL I/O error or equipment malfunction; condition code 2 during STIDC instruction. 

Channel and unit indicate whether device in error is SYSRES or communication device. 

When byte 3 = X'OO', byte 2 indicates the channel for which STIDC instruction was 

issued. Re-IPL system. 

. . , . _... _., _..., 



Notes: 1. A (X'CV) = S YSR EC recording unsuccessful. 
I (X'C9') = S YSR EC recording incomplete. 
S <X'E2') = SYSREC recording successful. 

2. S (X'E2') = Run SEREP. 

3. SDAID wait states are identified by X'EEEE' 
in the address part of the wait PSW. 

Table 3-1 . WAIT STATE coded messages, part 1 of 2. 
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Section 3 

WAIT STATE CODES 



BYTEO 


BYTE 1 


BYTE 2 


BYTE 3 




SDAID Hard Wait Code 


X'61' 


X*E6'(3) 


Channel 


Unit 


Another device is running in burst mode on same channel as SDAID output device. 
Re- 1 PL system. 


SDAID Soft Wait Code 


X'62' 


X'C5' 


Not used 


Not used 


SDAID output device became unready, Make printer ready and press the EXTERNAL 
INTERRUPT key. 


X'OO* 


X'OO'O) 


X'OO' 


X'OO* 


SDAID Stop on Event. Press EXTERNAL INTERRUPT key to 
continue operations. 


The folk 


jwing Har 


d Wait Cod 


es are placed in general register 1 1 X'B' as well as in low address storage. 


X'OO' 


X'OO' 


X'OF* 


X'FF' 


Program Check in Supervisor. 


X'OO' 


X'OO' 


X'OF' 


X'FE' 


I/O error during fetch from System CIL. 


X'OO' 


X'OO' 


X'OF' 


X'FD' 


•Channel Failure if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'OO* 


X'OO' 


X'OF' 


X'FC 


Machine Check if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FB' 


Page Fault in Supervisor routine with identifier RID X'OO'. 


X'OO' 


X'OO' 


X'OF' 


X'FA' 


Translation Specification Exception 


X'OO' 


X'OO' 


X'OF' 


X'F9' 


Error on Paging I/O. 


X'OO' 


X'OO* 


X'OF' 


X'F8' 


CRT phase not found. 


X'OO' 


X'OO' 


X'OF* 


X*F7' 


No copy blocks available for BTAM appendage I/O request. 


X'OO' 


X'OO' 


X'OF* 


XF6' 


$MAINDR canceled during system CIL update. If this occurs, the system CIL is only 
partially updated and must be restored before use. This hard wait condition can also occur 
if the FETCH QUEUE BIT (FCHQ) is set in the linkage control byte in the partition 
communication region owned by the terminating partition. 


Device E 


rror Reco 


very Wait C 


odes place 


d in low address storage. 


X*08' to 


X'd'or 


Channel 


Unit 


Error recovery messages. Refer to OP messages in DOS/VS Messages. 



Notes: 1. A (X'CV) = SYSREC recording unsuccessful. 
I (X'C9') = SYSREC recording incomplete. 
S <X'E2') = SYSREC recording successful. 

2. S (X'E2') - Run SERE P. 

3. SDAID wait states are identified by X'EEEE' 
in the address part of the wait PSW. 

Table 3-1. WAIT STATE coded messages, part 2 oil. 
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^jju^r 



Start 



Error during IPL 

CHART 01, PART 1 



Ensure that you have set the correct 
address for the device to be used as 
SYSRES, and check that the correct 
SYSRES pack is mounted. 



Ensure the word TEST is not di played 
or the TEST indicator is not 'ON'. 
If it is, establish the reason through 
your shift manager or IBM CE. 




I System CHECK indicators 

\ are explained in the 

| OPERATING PROCEDURES 

\ manual for your Model of System/370 



Yes 



c 



Inform IBM 
immediately 



~) 



Which of the following did you do after LOAD? 



Ready a 
card reader 



Press 
EXT INT 



Press 
REQUEST 






Supervisor required 
must be specified in 
first card read 




No 



Supervisor 1 selected 
by default 



Specify the supervisor 
required 



rHard wait message 
See Table 3-1 



Which of the following did you do next? 



Ready a 
card reader 



or 
I 



Press 
EXT INT 



IPL communication 
device is the card reader 
made ready 



or 
I 



Press 
REQUEST 



IPL communication device 
is the card reader assigned 
during system generation 



IPL communication 
device is SYS LOG 



o 



To part 5 



To part 2 
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Error during IPL 

CHART 01, PART 2 



From part 1 



c 



0110AGIVE IPL CONTROL COMMANDS 



For example: 

01151 PUB ALREADY EXISTS 




No 



To part 3 



Yes 



Complete operator action > 
under appropriate message 
number in DOS/VS Messages / 



See D-1-F For Models 135, 145, 11 
and D-2-F for Models 115, 125 
and D-3-F for Model 158 



Coded messages stored in bytes \ 
0-3 of low address storage are \ 
listed in Table 3-1 on page 3.3. i 



Dump, or display and note the 

• Current PSW 

• 16 Control registers 

• 16 general registers 

• Low address storage 



c 




Yes 



(^Complete operator/programmer 
^action. See Table 3-1 . 



To part 8 



v> 



3.6 Debugging for Operators. 



Error during IPL 
CHART 01, PART 3 



From part 2 




Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 



See D-1-F for Models 135, 145, 155-11 
and D-2-F for Models 115, 125 
and D-3-F for Model 158 



Coded messages stored in bytes 
0-3 of low address storage are 
listed in Table 3-1 on page 3.3 



0I20I DOS/VS IPL COMPLETE 



vy 




Yes 



/ Complete operator/programmer \ 
\ action. See Table 3-1 on page 3.3 J 



Yes 



Proceed with normal job 
processing 



Put SYSRES on a different drive, 

and if possible, select a different 

channel. 

(Do not forget to set the new 

address for SYSRES.) 



Re-IPL 




To part 4 



%J 



Debugging for Operators. 
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Error during IPL 
CHART 01, PART 4 



From part 3 



0I20I DOS/VS IPL COMPLETE 




Yes 



No 



Use the reserve (backup) 
SYSRESpack 



Re-IPL 



0I20I DOS/VS IPL COMPLETE 




Yes 



Is it the first IPL for 
a newly assembled 
supervisor? 



Save notes about your 

problem and actions, 

and inform your shift manager. 



No 




Proceed with normal 
job processing 



o 



Yes 



See D-1-F for Models 135, 145, 155-1 1j 
and D-2-F f or Models 1 1 5, 1 25 
and D-3-F for Model 158 



No 



Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 



Save the notes about your 
problem and actions, and 
inform your system programmer. 



Execute a stand- 
alone dump. 
A-3-F. 



For programmer action 
see section 4 (Chart 01 ) 



Save the hard copy of 
SYSLOG output and the 
stand-alone dump for IBM 



Inform IBM of 
your problem 



O 
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Error during IPL 
CHART 01, PART 5 



From part 1 




No 



See D-1 -F for Models 1 35, 145, 1 55-1 1 
and D-2-F for Models 115.1 25 
and D-3-F for Model 158 



The first character of a message 
originated by IPL is a 



Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 




To part 6 







Yes 



Put SYSRES on a different drive, and if 
possible, select a different channel. 
(Do not forget to set the new 
address for SYSRES.) 



Complete operator action under 
appropriate message number in 
DOS/VS Messages 



01201 DOS/VS IPL COMPLETE 




Yes 



See D-1-F for Models 135, 145, 155-11 = 
and D-2-F for Models 1 1 5, 1 25 
and D-3-F for Model 1 58 



Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 1 6 general registers 

• Low address storage 



Proceed with normal job 
processing 



To part 8 
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Error during IPL 

CHART 01, PART 6 



See D-1-F for Models 135, 145, 155-11 
and D-2-F for Models 1 15, 125 
and D-3-F for Model 158 

Coded messages stored in bytes 
0-3 of low address storage are 
listed in Table 3-1 on page 3.3 



0I20I DOS/VS IPL COMPLETE 



0I20I DOS/VS IPL COMPLETE 



From part 5 



Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 1 6 general registers 

• Low address storage 




Yes 



Complete operator action N 
under appropriate message 
number in DOS/VS Messages . 



Yes 



Put SYSRES on a different drive, 

and if possible, select a different 

channel. 

(Do not forget to set the new 

address for SYSRES.) 



I Proceed with normal processing J 




o 



Yes 



Use the reserve (backup) 
SYSRES pack 



Save notes about your problem 
and actions, and inform your 
shift manager 



Re-IPL 




(Pre 



Proceed with normal .processing 



To part 7 
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01201 DOS/VS IPL COMPLETE 



01201 DOS/VS IPL COMPLETE 






Is it the first IPL for 
a newly assembled 
supervisor? 






From part 6_ 




Yes 



No 



Use new IPL control cards 



Re-IPL 




No 




No 



Execute a stand-alone 
dump. 

A-3-F. 



Save the hard copy of 
SYSLOG output and the 
stand-alone dump for IBM 



Yes 



Yes 



Inform IBM of 
your problem 



Error during IPL 
CHART 01, PART 7 



Save notes about your 
problem and actions and 
inform your shift manager 



Proceed with normal 
job processing. 



Execute a stand-alone 
dump. 

A-3-F. 



Save the notes about your 
problem and actions, and 
inform your system programmer. 



3 C 



For programmer action 
see Section 4 (Chart 01 ) 
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Error during IPL 
CHART 01, PART 8 



From part 2 




Yes 



Proceed with normal 
job processing 



From part 5 




Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 



!See D-1-F for Models 135, 145, 155-11 
land D-2-F for Models 115, 125 
land D-3-F for Model 158 



Coded messages stored in bytes 
0-3 of low address storage are 
listed in Table 3-1 on page 3.3 




Yes 



No 



Execute a stand- 
alone dump. 
A-3-F 






If possible, use a different 
device as IPL communication 
device. 



Use reserve SYSRES pack, 
and if communication 
device is SYSRDR, use a 
new IPL control card deck. 



Re-IPL 




Re-IPL 



Yes 



Re-IPL 



No 





To part 9 



A 
To part 5 




To part 9 



c 
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Error during IPL 

CHART 01, PART 9 



From part 8 



From part 8 




0I20I DOS/VS IPL COMPLETE 




Yes 



No 




Proceed with normal 
job processing 



Execute a stand 
alone dump. 
A-3-F 






Inform your shift 
manager of your 
problem 



No 




Is it the first IPL for 
a newly assembled 
supervisor? 



Yes 



Execute SEREP 
(Refer to F-4-F for 
Models 135, 145, and 
155-1 Dor 
Display log analysis 
(Refer to F-5-forthe 
Models 115 and 125 or 
F-6forthe Model 158) 



Save the low address 
storage dump, the stand- 
alone dump, and the 
SEREP printout for IBM. 



Save the notes about 
your problem and 
actions, and inform your 
system programmer. 



Rebuild SYSRES. 

Save the original SYSRES. 

Save the low address 

storage dump. 

Save the stand-alone dump. 

Inform IBM of your 

problem. 



© 



Inform IBM of 
your problem 



For programmer action 
see Section 4 (chart 01 ) 



Proceed with normal 
job processing 
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Initial System Checks 
NOTES FOR CHART 02 



r 



Note 1 < 



Note 2 1 



Recognizing a wait state 

Any of the following observations confirm that the system is in a Wait State: 

• WAIT indicator remains on, or on the Models 1 15 and 125 the word WAIT 
remains displayed on the video display unit 

• SYS indicator remains off (Not applicable to the Models 1 15 and 125). 

• No I/O device activity occurs. 

• One or more SYSTEM CHECK indicators on. 

• A HARD MA CHINE CHECK message is issued on SYSL OG or a 
coded "wait state" message may be contained in bytes 0-3 of 
low address storage or in GR II (X'B') 

Recognizing a loop 

One or more of the following occurrences may indicate that a job /program is in 
an unintended loop: 

• A steady glow in the light of the system control panel with the SYS indicator 
on. For the Models 1 15 and 125, the word WAIT may flicker on the video 
display unit. (This depends on the size and nature of the loop.) 

• A rhythmic pattern in the lights of the system control panel, or, for the 
Models 1 15 and 125, the word WAIT may flicker on the video display unit. 

• A pointless recurrence of I/O activity. 

• A job/program that does not change status for a long time. This may result, 
for example, in an absence of I/O activity with both SYS and WAIT 
indicators on. 

A note to the operator: When a loop is recognized, first try to contact the 
programmer before beginning any debugging procedures. If this is not possible, 
follow the instructions in chart 04. 



> 



Note 3 < 



Recognizing incorrect output 

Incorrect output during system operation may be recognized by any one of 
the following: 

A. Duplicate output 
Output of identical data or more output than expected on: 

• line printer 

• console printer 

• card punch 

• video display unit. 

B. Invalid or unidentified output 
Printed (or displayed) output that is obviously incorrect on: 

• line printer 

• console printer 

• video display unit. 

C. Lack of output 
No output when there should be,or less output than expected on: 

• line printer 

• console printer 

• card punch 
\ • video display unit. 

I Job/program canceled by system 

The system's canceling of job is normally caused by a Program Check Interrupt 
that is recognized by a message, for example: 

BG 0S031 PROGRAM CHECK INTERRUPTION - HEX LOCATION 0610F8 
Note 4 <J CONDITION CODE 2 - SPECIFICATION EXCEPTION 

0S001 JOB NO NAME CANCELED 

The program is automatically canceled by the supervisor and depending on the 
use of the job control statement, // OPTION DUMP, a dump of the partition 
and supervisor is executed. 



J 



o 
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- Check 1 

Message on 
SYSLOG 



- Check 2 

Output from 
job/program 
(See note 3) 



Initial System Checks 

CHART 02 



Did you understand the message and respond to 

it correctly? If no message was printed, go to check 2. 



Yes 



Save SYSLOG 
output, and go to 
check 2. 



No 



Contact your shift manager 
before rerunning or restarting 
the job/program 



Is there unscheduled output? 

Is scheduled output not as expected? 



Yes 



No 



Save the output, 
and go tocheck 3 



Make a note, and 
go to check 3. 



JT\ 



- Check 3 

Input/output 
devices. 



- Check 4 — i 

Input/output 
media 



- Check 5 — 

Program change 
during run 



- Check 6 

Programmer's 
instructions 



Are the assigned devices set up correctly? (e.g. bits per inch) 



No 



Rerun or restart 
job/program. 



\l 



Have any of the assigned devices a malfunction 
condition? (Some examples of device malfunctions 
are listed in Section 1.) 



Yes 



Try to use a different 
device or consult the 
operating guide for the 
device, and inform your 
IBM customer engineer. 



No 



Go to check 4. 



Are you using correct SYSRES pack? 

input files/volumes? 
work files/volumes? 
Input/output devices? 
teleprocessing lines? 



No 



Yes 



Contact your shift manager 
before rerunning or restarting 
the job/program 



Go to check 5. 



Have you altered the contents of any real or 
virtual address area since the job/program began 
running? 



Yes 



No 



Compare your notes 
of the alterations 
with the programmer's 
instructions. If there 
is a difference, try to 
contact the programmer 
before rerunning the job. 



Go to check 6. 



Do you understand the programmer's 

instructions? 

(If in doubt, try to contact the programmer.) 



No 



Yes 



Contact your shift manager 
before rerunning or restarting 
the job/program 



Go to check 7. 



- Check 7 

Operating 
procedures 



Are there any recent changes in the system 
operating procedures, and if so, do they affect 
this job? 

(If in doubt, contact your shift manager or 
senior operator.) 



Yes 



No 



Contact your shift manager 
before rerunning or restarting 
the job/program 



Go to check 8. 



© 



- Check 8 

Categorize the 
malfunction 




System in a WAIT STATE? (See note 1 ) 
LOOP? (See note 2) 

Obviously incorrect output? (See note 3) 
Job/program canceled by system? (See note 4) 



Turn to chart 03 


Turn to chart 04 


Turn to chart 05 


Turn to chart 06 
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Wait State 
CHART 03, PART 1 



Model-dependent 
control console 
layout 


sea 


5)®©©©(2)© 

BE) H 6S5BS E] 



Start 



I SYS MAN WAIT TEST LOAD ■ <: 

|o6oooi 



WAIT indicator ON 
SYS indicator OFF 



Yes 



i 



The TEST indicator is on when any of the following 
switches are not in the process or normal position. 

1. RATE 

2. CHECK CONTROL 

3. DIAGNOSTIC/CONSOLE FILE CONTROL 

4. ADDRESS COMPARE CONTROL 




No 



Yes 



1 



The MANUAL indicator is on when the CPU clock is 
stopped or the system is in a soft-stop state. All pending 
interrupts are handled. Manual store/display operations 
are possible only when the MANUAL indicator is on. 



Yes 



I 



If SYSLOG is inoperative, a device error recovery message 
may have been printed on the line printer assigned as 
SYSLST. 

Example of a device error recovery message 



0P08A INTERV REQ SYSRDR=00C 







Inform your shift leader or 
manager of the condition, 
and request time for 
hands-on debugging to 
gather system information. 



Consult DOS/VS 
Messages manual 




To part 2 of this chart 
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From part 1 of this chart 



Wait State 
CHART 03, PART 2 




AR 1I60A READY FOR COMMUNICATIONS. 



Yes 



Yes 



See D- i F for Models 1 35, 145, 1 55-1 1 
and D-5-F for Models 1 1 5. 1 25 
and D-6-F for Model 158 



Check that the last JCL 
assigning SYS LOG was a 
statement and not a 
command 



No 



No 



Dump or display low 
address storage. Use 
ALTER/DISPLAY 



Compare the contents of 
bytes 0-3 of low address 
storage with the list of 
wait state coded messages 
shown in table 3.3 on 
page 3.4 




Yes 




Yes 



Yes 



No 



Continued debugging using 
the flowchart shown in 
Section 2,E-3-F. 



SOFT WAIT 




To part 6 of this chart 



D 



To part 3 of this chart 
Debugging for Operators. 
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Wait State 

CHART 03, PART 3 



From part 2 of this chart 



Issue the MAP command. 
Refer to Section 2, E-1. 



Make each I/O device 
NOT READY, then 
READY in turn, checking 
for any I/O activity as 
this action is carried out. 



No 





Does not apply to 
POWER/VS RJE tasks 



No 



Yes 



Contact terminal (s) and 
request data to be 
entered 



Yes 




If an interrupt occurs, the CPU 
is taken out of the wait state,; and 
processing is started under control 
of the program being executed. 



No 



o 



To part 4 of this chart 
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From part 3 of this chart 



Wait State 
CHART 03, PART 4 



1Q12I POWER/VS INITIALIZATION COMPLETED 




To part 6 
of this chart 



Enter command 
PINQUIRE ALL to 
check status of 
RJE line(s) 



No 




Contact the terminal (s) 
showing inactive jobs 
and request environ- 
mental check and /or 
reason for not signing on 



To part 6 
of this chart 



To part 5 
of this chart 



To part 5 
of this chart 
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Wait State 

CHART 03, PART 5 



From Part 4 
of this chart 



From Part 4 
of this chart 



No 



Issue the command 
PDISPLAY RJE to 
obtain a status report 
of RJE queue entries 




Either wait for problem 
to be solved at terminal 
or issue the command 
PSTOP line address 
to cancel that RJE line. 



1R17I LINE HAS BEEN 
SfOPPED 




Issue the following commands: 
PDISPLAY RDR,ALL 
PDISPLAY LST,ALL 
PDISPLAY PUN,ALL 
Then after the output, if any, 
use the PSTOP command to 
stop the tasks or partition(s) 
running under POWER/VS 




I 1Q33I STOPPED ttt, cuu 



Yes 



Issue the command 
PENDKILL,00E 



System dump § 
is described in 1 
section 2,A-2 i; 




No 



w 



Yes 



Yes 



To part 6 of this chart 
3.20 Debugging for Operators 



Continue normal 
system operation 




\^J 



To part 6 
of this chart 
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Wait State 
CHART 03, PART 6 



From part 2 of this chart 




Execute a stand 
alone dump 
A-3-F 






Execute SEREP (Refer to 
F-4-Ffor Models 135, 145, 
and 155-11) or Display log 
analysis (R.glexJ&.F^j^pr 
t he Mo dels n5_and 125 or 
F-6 foTThn?lodelT58ir 



RE-IPL 



If the problem recurs, re-IPL 
and execute EREP (select 
default options) F - 3 - F 



Have the SEREP, EREP 
and stand-alone dump out- 
puts available for your IBM 
customer engineer 



HARDWARE ERROR 

Note: Certain unusual hardware and software failures can 
cause the system to halt processing with both the system 
light and the wait light on continuously. This indicates that 
the current PSW has its wait bit set on but the CPU is 
processing microprogram instructions. If possible, the 
system should be left in this state until a customer engineer 
has arrived. A stand-alone dump can show the I/O 
operations in process. 



From part 2 and 4 
of this chart. 



From part 5 
of this chart 




Execute a stand-alone dump 
as recommended in Section 2, 
A-3-F. On completion of the 
dump, re-IPL and obtain a 
dump or copy of the page data 
set as described in Section 2, C-6 



Re-IPL and obtain 
a dump or copy of 
the PDS, C-6 



Save the following system 
information fo the system 
programmer: 

• SYSLOG output including 
MAPandPINQUIRE 
command output 

• Line printer output, including 
the stand-alone dump output, 
the dump or copy of the 
page data set, and the 
POWER/VS system dump 

(if applicable) 

• If the stand alone dump 
was executed, a note of: 

Current PSW 

16 control registers 

16 general registers 

Low address storage 

X'OO'-'BF' 

• Job stream (if possible) 

• Note of system activity 

• Note of your actions 

• Input files/volumes 

• (if possible) 



OPERATIONAL 

OR 
PROGRAMMING ERROR 
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Unintended Loop 

CHART 04, PART 1 



r 



Start 



Inform your shift leader or 
manager of the malfunction 
and request time for hands-on 
debugging to gather system 
information, if possible, 
check estimated job run 
times with the programmer(s) 



r 



From part 5 of this chart 



Press REQUEST 



Determine if 
loop is in < 

supervisor 



V. 



Yes 





AR 1I60A READY FOR COMMUNICATIONS 



NO 



Loop is probably 
in the supervisor. 



No 




Yes 




g A program or partition is time dependent when it uses 
one or any of the following I/O methods: MICR 
(Magnetic Ink Character Recognition), OCR 
■ (Optical Character Recognition), TP (Telepro- 
cessing) 



No 



No 



No 



Yes 



TP suspected of causing loop 




MICR and/or OCR 
suspected of causing loop. 



3.22 



To part 2 of this chart. 
Debugging for Operators. 



B 
To part 3 of this chart. 



o 





To part 4 of this chart. 



To part 4 of this chart. 
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From part 1 of this chart. 



Unintended Loop 

CHART 04, PART 2 



r 



Actions to prevent the 
following procedures 
affecting MICR/OCR. 



< 



K. 



Any 

, 'partition using* . 
JV1ICR and/or OCR^, 
sin put method. 

Yes 



No 



Empty the hopper of the 
MICRand OCR devices 



If the message 
INTERV REQ is issued on 
SYS LOG for the MICR 
and/or OCR devices, DO 
NOT READY these devices 



If possible consult your 
shift leader or manager 
before making this 
decision. 




No 



Execute the MAP 
command; refer to Section 
2, E-1. 




To part 5 of this chart. 



No 



For system programmers and IBM CE/SEs only. 

If possible assign SYSLST to a line printer on the 
partition being used to initiate SDAIDS. If a line 
printer is not available assign SYSLST to a tape 
unit or disk drive. (In the last case disk label 
information must be supplied.) 

Initiate SDAID BR trace between limits of partition 
owning failing program. Refer to B-10-F. (Partition 
limits can be obtained from the MAP output.) 

In conjunction with the assembly listing of the 
failing program you may be able to localize the 
error by scanning the SDAID output. 

You can further localize the error by adding IF, 
SA, and GA trace routines via CR 9 and reducing 
the event limits via CR 10 and 1 1 . 




No 



To part 6 of this chart. 



H 

\/ 

To part 6 of this chart. 
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Unintended Loop 

CHART 04, PART 3 

From part 1 of this chart 



B 



\J 




Inform terminal (s) of 
malfunction condition 




No 



Yes 




No 



Yes 



No 



Partition using TP 
is causing loop 



No 




No 



Yes 



TP is causing loop 



Loop is in partition using TP 




Yes 




Yes 



Partition using TP 
is not causing loop 



Inform terminal (s) that there will be TIME-OUT and that program using TP 
may have to be restarted or re-run at some other time, because of 
hands-on debugging procedures 



No 



To part 4 of this chart 



A 



To part 2 of this chart 



No Loop; continue 
processing 



vy 



To part 4 of this 
chart 
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Unintended Loop 

CHART 04, PART 4 



From part 1 of this chart 



Press STOP on all 
MICR/OCR devices 




No 



From part 1 , or part 3 
of this chart. 



f*\ 



Yes 



Loop involves operation 
on MICR/OCR 



Trace loop by instruction 
step method. 



|See D-4-F for Models 135, 145, 155-1 1 
,and D-5-F for Models 115, 125 
land D-6-F for Model 1 58 

Note: 

It is important that at least 
15-20 instructions in the 
loop are noted. A trace of 
complete loop depends on 
time allowed for debugging. 






To part 6 of this chart 
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Unintended Loop 

CHART 04, PART 5 



From part 2 of this chart 



r 



Pause all jobs to 
free a partition. 







Press REQUEST 



-< 



\^ 



An EOJ is indicated by the SYS LOG message 

XX READY FOR COMMUNICATIONS 

(XX indicates the partition issuing the message). 



When Attention Routine 
is initiated (AR issued 
on SYSLOG), enter 
PAUSE BG, EOJ 
PAUSE F4, EOJ etc, to 
pause all partitions. 




No 



Yes 



Execute the MAP 
command; refer to Section 
2, E-1. 



Before proceeding, check 
estimated job run time, either 
by contacting the programmer 
or from program run sheet 




To part 1 of this chart 




No 



For system programmers and IBM CE/SEs only. 

If possible assign SYSLST to a line printer on the 
partition being used to initiate SDAIDS. If a line 
printer is not available assign SYSLST to a tape 
unit or disk drive. (In the last case disk label 
information must be supplied.) 

Initiate SDAID BR trace between limits of partition 
owning failing program. Refer to B-10-F. (Partition 
limits can be obtained from the MAP output.) 

In conjunction with the assembly listing of the 
failing program you may be able to localize the 
error by scanning the SDAID output. 

You can further localize the error by adding IF, 
SA, and GA trace routines via CR 9 and reducing 
the event limits via CR 10 and 1 1 . 




To part 6 of this chart 
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Unintended Loop 

CHART 04, PART 6 



From part 5 of this chart. 



At this stage, if only one job has not reached 
EOJ, it is possible that this job is causing the 
loop. Check estimated job run time with 
programmer or on program run sheet 



From part 2 of this chart 



1""^ 



Let system continue 
processing. Programmer 
must immediately 
analyze the problem 



Turn to Section 4, 
Chart 01, Part 2 




Yes 



More than one job still 
running 




Yes 



Execute a stand-alone dump 
as recommended in Section 2, 
A-3-F. On completion of the 
dump, re-IPLand obtain a dump 
or copy of the page data set as 
described in Section 2, C-6. 



Save the following for the 
programmer: 

• SYSLOG output 

• Line printer output 

• Job stream 

• I/O files/volumes 

• Loop trace (instruction 
step or SDAID output) 

• MAP, if applicable. 



Re-IPL: initiate 
different jobs 



) 



Loop is probably caused 
by this job 



Trace loop either by 
instruction step (See 
note 1 ) or by using SDAID 
routines B-10-F (See 
note 2) 



From part 2 or 4 of this chart 



Note 1: 

See D-4-F for Models 135, 145, 155-11 
and D5-F for Models 1 15, 125 
and D-6-F for Model 158 

Note 2: 

SDAID should be used 
only by system programmers 
or by IBM CE/SE. 
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Obviously Incorrect Output 

CHART 05 



Start 



The identity of the partition using the device: 

This can be deduced from information given on 

the job run sheet, or the device ASSGN statements 

and commands issued on SYSLOG and SYSLST. 

An alternative method is to make the device producing 

incorrect output NOT READY. This will cause a 

device error recovery message to be issued on SYSLOG. 

Determine the partition using the device from the 
message printed on SYSLOG as a result of this action. 



K possible, contact the programmer 
to establish the expected output, 
and identify which job or partition 
is using the device that is 
producing the incorrect output 



BG 



0P08A INTERV REQ SYS008 = 



383 



Partition identity 



I/O Device Address 



Make the device producing 
incorrect output NOT READY 



Press REQUEST and wait for 
message 0P60D, then enter 
IGNORE 



XJ 



AR 1I60A READY FOR COMMUNICATIONS, 



If SYSLST for the partition to be dumped is not 
assigned to a line printer, use the line printer 
assigned as SYSLST on another partition. 
For example, DUMP F2S(BG). 
Note: This may produce dump output from the 
partition being dumped, interspersed with 
output from the program using the line printer. 



A System dump may be issued on the device assigned to 

SYSLST for the partition being canceled. 

(The System dump is described in Section 2, A-2.) 



Respond to the AR message 

by issuing the DUMP command 

to dump the partition and the 

supervisor, for example, DUMP F2S 

SYSLST must be assigned to a 

line printer. 

Refer to Section 2, A-1 



Cancel the job in the partition 
producing the incorrect output 



Save the following information 
for the programmer (s). 

• SYSLOG output 

• Line printer output, including 
all dump output 

• Job stream 

• I/O files/volumes 
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1974, 



Program Canceled 

CHART 06 



Start 



An informative message 
is issued on SYS LOG 
orSYSLST, or both 



0P731 JOB DEBUGEX8 CANCELED DUE TO I/O ERROR 
0S071 PROBLEM PROGRAM PSW 031 0000000007 A02 



BG 0P24I C PROG CHECK SYS009=00D 

CCSW=001 000022800200000 CCB=007A0E 

SNS=0000000000000000000000000000000000000000000000001 
BG 0P73IJOB DEBUGEX8 CANCELED DUE TO I/O ERROR 







An example of a job cancellation 
message issued on SYSLST 



An example of a job cancellation 
message issued on SYS LOG 



If the message 1Q30D ABNORMAL 
POWER/VS TERMINATION 
PRINTER= is issued on SYSLOG 
the program check occurred in the 
POWER/VS partition. To obtain a 
dump, you must respond to the 
message and specify a line printer 
device address. 



J 



A system dump is issued 
to the device assigned as 
SYSLST 



. A system dump is issued to SYSLST under the 

\ following conditions 

\ 1. The supervisor in use supports the OPTION DUMP, 

which is not overruled by the job control statement 
\ II OPTION NODUMP in the job stream. 
1 2. The job control statement // OPTION DUMP is 

included in the job stream. 
I Note: If the program check occurred in a program 
[running under POWER/VS, the dump will be output 
\ to the spooling device. 

\ For a complete description of the system dump, refer to 
'Section 2, A -2. 



SYSLS 
assigned 
Jine prin 



Yes 



3T\ N ° 


Dump the di 


;k extent, or 


to a y™ ^ 

ter, — 


to obtain a printed dump 









Execute the 
MAP command 
(refer to section 
2, E-1) 



Save the following information 
for the programmer: 

• SYSLOG output 

• Line printer output, including 
any error messages and the 
system dump 

• Job stream 
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For your notes 

if . 



o 



3.30 Debugging for Operators. 



DOS/VS Serviceability Aids and Debugging Procedures 

SECTION 4 






DEBUGGING FOR 
SYSTEM PROGRAMMERS 



/"> 



%J 



Section 4, DOS/VS Serviceability Aids and Debugging Procedures 

DEBUGGING 

PROCEDURES 

FOR SYSTEM 

PROGRAMMERS How to use 



The choice of serviceability aids and methods of off-line program debugging and of 
analyzing each programming error rests with the programmer. The flowcharts in 
this section, however, will help the programmer to choose the method best suited to 
the type of error. For efficient analysis of dumps, program output, and printouts, 
an understanding of DOS/VS information blocks and supervisor interface tables is 
required. This section describes how your programs, referred to as user programs, 
interface with the IBM System Control Programs (SCPs). It also illustrates the 
allocations of storage, program and supervisor save areas, and details the informa- 
tion contained in the interface tables useful for program debugging. 

The debugging of user programs written in a high-level language or for use with 
teleprocessing are not discussed. However, the serviceability aids described in 
Section 2 and the operator procedures of Section 3 should be used initially to 
gather information from the system. Having obtained the information, the procedures 
in this Section can then be used inconjunction with the debugging procedures 
described in the applicable high level language or teleprocessing component manuals. 

This Section is divided into two parts. The first part consists of checklists in the 
form of flowcharts that should be used as a guide during offline program debugging. 
They help in selecting a method of analysis, and if required, help in the choice of 
the serviceability aid for further error isolation. 

The second part of this section consists of a general description of the DOS/VS 
supervisor tables, information blocks, and save areas, together with other system 
information useful for offline debugging. More details about these tables and areas 
can be found in the IBM publication DOS/VS Supervisor Logic. 

Note: It is assumed that the programmer using this section is familiar with DOS/VS 
multiprogramming, asynchronous processing (multitasking), relocating load, virtual 
storage, and data management techniques. These techniques are described in the 
DOS/VS System Management Guide. 



\\ 
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Section 4, Part 1 

CONTENTS 



c 



Flowcharts for offline debugging 

1. Initial checks on the program and its input 4.2 

2. Programming errors that generate problems during IPL 4.5 

Isolating errors that cause the system to enter a WAIT STA TE. 

3. HARD WAIT STATE with a coded message in low address storage 4.7 

4. HARD WAIT STATE with no coded message in low address storage 4.8 

5. SOFT WAIT STATE 4.9 

6. Isolating errors that generate unintended program loops 4.1 1 

7. Isolating errors that produce incorrect output that is detected after an 

indefinite time since execution of the program 4.12 

8. Isolating errors that produce incorrect output that is detected either during, 

or immediately after execution of the program 

Isolating errors that cause program/job cancellation: 

9. Because of a PROGRAM CHECK in a user written program 4.19 

10. Because of an ILLEGAL SVC 4.25 

11. For other reasons 4.26 

12. Because of a PROGRAM CHECK within the supervisor area 4.27 

POWER/ VS 

13. Problem analysis for programs running under POWER/VS 4.30 
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Initial Checks 

CHART 01, PART 1 OF 2 



Start 



Program Error 
recognized by: 



Operator 
not able 
to IPL 



Operator during 
execution of 
job/program 



Error during IPL 



System entered 
a wait state 



Incorrect output 
detected at some 
time after running 
the job/program 



Turn to chart 07 
in this Section 



Unintended loop 
developed 



Program produced 
obviously incorrect 
output 



Job/program 
canceled 



The operator should supply this data gathered from the system when the error occurred 



SYSLOG output. 
Dump, or note of 
low address storage 
bytes X'OO'-X'BF' 
Stand-alone dump. 
SYSRESpackin use 
when error occurred. 



SYSLOG output. 
Dump, or note of low 
address storage & current 
PSW. 

Stand-alone dump. 
Dump or copy of SYSVIS. 
Any line printer output 
when error occured. 
Job stream. 

Note of Input/output files/ 
vols. SEREP/EREP output 
if applicable to cause 



SYSLOG output 

Partition dumps, if any 

taken. 

MAP of system. 

Job stream. 

Any line printer output 

when error occurred. 

Stand-alone dump. 

Dump or copy of SYSVIS 

Loop trace, either 

manual or SDAID. 



SYSLOG output 
Line printer output, 
including the dump 
of the partition using 
the device producing 
incorrect output. 
A dump of the 
supervisor, or a 
System dump. 
Job stream. 
All input/output files/ 
vols used by the 
partition dumped. 



SYSLOG output 
System dump (if 
executed). 
Any line printer 
output from Job, 
including any 
messages. 
Job stream. 






The application programmer should supply you with this data to aid problem analysis 



As the system programmer 

you may require: 
Supervisor listing 
of supervisor in use. 
Linkage editor map 
for the supervisor 
in use when error 
occurred. 



Program listings of 
all programs being 
executed when error 
occurred. 

Linkage editor maps 
for the programs. 
Supervisor listing for 
supervisor in use. 



Program listing of the 
program in which 
loop developed. 
(If loop was not 
isolated to a partition, 
program listings of all 
programs being 
executed when loop 
occurred may be 
required.) 

Linkage editor map 
for program (s). 



Program listings. 
Linkage editor map. 



As the system programmer 
you may require: 

Program listings. 

Linkage editor map. 

Supervisor listing. 



Turn to chart 02 
in this Section 



To part 2 
of this chart 



4.2 Debugging for Programmers, part 1 . 



From part 1 
of this chart 



A 



Y 

Check 1 

Error messages 



I — Check 2 — 

Program execution 



i — Check 3 — i 

Program, or module 
(sub-routine) coding 



O L" 



Check 4 

Input media 



i — Check 5 

Input/output 
device and type 



i — Check 6 - 

DOS/VS level of 
release 



Check 7 

Job control 
statements 



, — Check 8 — i 

System hardware 
configuration 



o 



, — Checkd - 

Categorize error 




Initial Checks 

CHART 01, PART 2 OF 2 



Look for messages on console printer log sheet, or 
line printer output associated with the job in error. 



Consult "Programmer Action" listed in 
DOS/VS Messages. If solution to 
problem not found, return to check 2. 



No 



Has the program ever run successfully? 



M 



Yes 



•/Has there been a reassembly of the program, or any 
module used by it, since the previous run? 

• Has the program or any module used by it been 
recataloged since previous run? (For example, 

a change in LOAD or ENTRY addresses.) 

• Has any coding been changed by REP or SOURCE 
cards? 

• Has an IBM programming temporary fix (PTF) 
been applied to the program, or any of its modules? 




• Has there been any change in the location of data 
on any of the input files? (For example, the area 
containing the data on a disk pack has been moved 
to another address either on the same pack, or on a 
different pack.) 

• Has there been a change in any input media? (For 
example, input data was previously on cards, but has 
since been transfered to disk pack.) 



Was a different physical input/output device type 
assigned? (For example, in the previous run, I/O 
device was a 3330 disk drive, but is now a tape unit.) 




• Did the program run previously under the same 
supervisor DOS/VS release? 

• Was the same supervisor used for both runs? 

• Have there been any changes to the supervisor, since 
the previous run? (For example, re-system generation) 



Has there been any real change in job control since 
previous run? (For example, a change in the // EXEC 
parameter to REAL from default.) 



Was the program executed on a different system 
configuration from the previous run? 
(For example, a different model of CPU.) 




■Program error recognized by: 
WAIT state 



LOOP 

Obvious incorrect output 
Job/program canceled 



Go to check 9 



Go to check 3 and continue through 
this checklist. It is recommended to make 
a copy of this chart and make notes 
(for future reference) in this column 
of any differences from previous 
execution of the program. 
At this stage there is no need for further 
action, unless the solution to the problem 
becomes obvious. 





Turn to chart 03 
Turn to chart 06 
Turn ot chart 08 
Turn to chart 09 



Debugging for Programmers, part 



4.3 



Intentionally Blank 
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Errors during IPL 
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Check 



— Check 1 

Supervisor listing 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



If the IPL procedure can not be completed 
and the supervisor in use has never been used 
on the system, check the supervisor assembly 
listing for flagged statements. Also note in 
the listing the options supported by the 
supervisor. 

Check that the hardware is present in the 
system for options supported by the super- 
visor that require hardware support. 

Also check that the supervisor is generated 
to support hardware options that are present 
on the system. 



If the cause of the error can not be isolated, 
inform IBM and have the following informa- 
tion available: 

• The supervisor listing 

• The stand-alone dump output, including 
the dump of the low address storage 

• The SYSRES pack used when the error 
occurred 

• Any notes about actions taken during error 
analysis both on and offline. 



■jr 
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Hard Walt Message Codes 
SUPPORT FOR CHART 03 






BYTEO 


BYTE 1 


BYTE 2 


BYTE 3 


EXPLANATION 


MCH/CCH/IPL Hard Wait Codes placed 


in low address storage 


x'cr 


X'E2'(2) 


A, I, SO) 


Not used 


Irrecoverable machine check. 


X'C2' 


X'E2'(2) 


Not used 


Not used 


Irrecoverable channel failure during RMS fetch. 


X'C3' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure on SYSLOG when RMS message scheduled. 


X'C4' 


X'E2'(2) 


A, I, SO) 


Not used 


No ECSW stored 


X'C5' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure: ERPBs exhausted. 


X'C6' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure; two channels damaged or a damaged channel situation occurred while RMS 
was executing an I/O operation. 


X'C7' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure; system reset was presented by a channel. 


X'C8' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure; system codes in ECSW are invalid. 


X'C9' 


X'E2'(2) 


A, I, SO) 


Not used 


Channel failure; channel address invalid. 


X'DT 


X'E2'(2) 


A, I, SO) 


Not used 


Irrecoverable channel failure on SYSVIS. 


X'07' 


X'E6' 


Channel 


Unit or 
X'OO' 


IPL I/O error or equipment malfunction; condition code 2 during STIDC instruction. 
Channel and unit indicate whether device in error is SYSRES or communication device. 
When byte 3 = X'OO', byte 2 indicates the channel for which STIDC instruction was 
issued. Re-IPL system. 


SDAID Hard Wait Code 


X'61' 


X'E6'(3) 


Channel 


Unit 


Another device is running in burst mode on same channel as SDAID output device. 
Re-IPL system. 


SDAID Soft Wait Code 


X'62 


X'C5' 


Not used 


Not used 


SDAID output device became unready, Make printer ready and press the EXTERNAL 
INTERRUPT key. 


X'00' 


X'00'(3) 


X'OO' 


X'OO' 


SDAID Stop on Event. Press EXTERNAL INTERRUPT key to 
continue operations. 


The foil 


swing Hard Wait Codes are plac 


3d in general register 1 1 X'B' as well as in low address storage. 


X'00' 


X'OO' 


X'OF' 


X'FF' 


Program Check in Supervisor. 


X'OO' 


X'OO' 


X'OF' 


X'FE' 


I/O error during fetch from System CIL. 


X'00' 


X'OO' 


X'OF' 


X'FD' 


Channel Failure if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FC 


Machine Check if MCH=NO. and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FB' 


Page Fault in Supervisor routine with identifier RID X'OO' 


X'OO' 


X'OO' 


X'OF' 


X'FA' 


Translation Specification Exception 


X'OO' 


X'OO' 


X'OF' 


X'F9' 


Error on Paging I/O. 


X'OO' 


X'OO' 


X'OF' 


X'F8' 


CRT phase not found. 


X'OO' 


X'OO' 


X'OF' 


X'F7' 


No copy blocks available for BTAM appendage I/O request 


X'OO' 


X'OO' 


X'OF' 


X'F6' 


$MAINDR canceled during system CIL update. 

If this occurs, the system CIL is only partially updated and must be restored before use. 
This hard wait condition can also occur if the FETCH QUEUE BIT (FCHQ) is set in the 
linkage control byte in the partition communication region owned by the 
terminating partition. 


Device E 


rror Recovery Soft Wait Codes 


placed in low address storage. 


X'08'to 


X'd'or 


Channel 


Unit 


Error recovery messages. Refer to OP messages in DOS/VS Messages. 



'% 



Notes: 1. A (X'CV) = SYSREC recording unsuccessful. 
I (X'C9') = SYSREC recording incomplete. 
S (X'E2') = SYSREC recording successful. 

2. S (X'E2') = Run SERE P. 

3. SDAID wait states are identified by X'EEEE' 
in the address part of the wait PSW. 

Refer to Section 2-E-3 for a list of IPL error message codes and a more detailed description of wait states. 



C 
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Check 



i — Check 1 

Eliminate components 



Check 2 

Type of Wait 



Page of GC33-5380-1, 
revised September 30, 1974, 
by TNL GN33-8793 



Method of Analysis 



Hard Wait with Message in Low Address Storage 

CHART 03, PART 1 OF 1 

Recommendations to Aid 
Further Problem Analysis 



Was POWER/VS initiated when the wait state 

occurred. 

Establish this from the SYSLOG logsheet, 

or the operator concerned. 



Yes 



No 



HARD WAIT STATE 



SOFT WAIT STATE 
(You may require an interview with the 
operator to verify if this type of wait 
occurred, and request information about 
system occurrence and messages printed 
prior to the wait state.) 



Examine bytes 0—3 of low address storage 
noted by the operator and the contents of 
GPR 1 1,X'B' in the dump output. Compare 
the contents with the coded messages 
listed on the opposite page. 

• If the code is listed analyze the program 
further based on the reasons given against 
the codes in the list. 

• If the code is not listed, turn to chart 13. 



Go to check 2. 



Proceed to check 3. 



Turn to chart 05. 



\^jV 



Check 3 



Analyze message in 
low address storage 



Use the dump, or notes made by the 
operator, of low address storage and current 
PSW, and the list shown on the opposite 
page. Also, refer to section 2-E-3. 
Analyze the message in bytes 0—3 to 
isolate a possible cause of the error. 



If GR 11 contains a hard wait code (see table 
opposite) or a hard wait code exists in bytes 2 
and 3 of low address storage, proceed to check 4, 
If there is no recognizable message turn to 
chart 04. 



- Check 4 - 

Locate old PSW 



- Check 5 — 

Locate failing 
instruction address 



Use the stand-alone output to locate: 

• the old PSW applicable to the message. 

• the instruction length code (Refer to 
section 2-E-2.) 

• the interrupt code. 

The reason for the error may be that a 
transient used by the program is not 
cataloged in the system core image library. 
Execute DSERV. (Refer to section 2-C-2.) 



Use the stand-alone dump output and 
supervisor listing to locate where in the 
supervisor the program check occurred (which 
routine). Analyze the failing instruction 
and compare the code of the instruction 
in the dump with the instruction in the 
listing. 



Calculate the failing instruction address by 
subtracting the length code from the instruc- 
tion address part of the PSW. Analyze the 
cause of the program check using the 
interrupt code. If you cannot isolate the 
error with this information proceed to 
check 5. 



Make certain that user routines have not 
altered the supervisor, and that the super- 
visor assembly is free of errors. Before 
calling for IBM programming support, 
execute the program with PDA ID F/L trace 
on all partitions to trace phases used. (Refer 
to section 2-B-2.) 

Also, use the SDAID stop on event program 
check and obtain a non-destroying dump 
when the stop occurs. (Refer to section 
2-B-10.) 

If the error cannot be isolated after re- 
analysis of the problem using the output 
obtained from the re-run, inform IBM. 
Have the following information available: 

• SYSLOG output 

• Supervisor listing 

• Program listing 

• Linkage Editor maps 

• Stand-alone dump 

• Dump or copy of SYSVIS 

• PDAI D and SDAI D output 

• Job stream 

• DSERV output if one was obtained. 
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Hard Wait, no Message in Low Address Storage 
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Check Method of Analysis 



Check 1 



Scan the stand-alone 
dump output 



A. Look for unexpected or unreasonable 
values in the following areas in the dump 
output: 

• PSWs in low address area (machine check 
old, program old, input/output old, SVC 
old, external old), and note interruption 
codes for the associated PSWs. 

• General purpose registers. 

• Control registers (see appendix C). 

• CSWand CAW (refer to section 2-E-2). 

B. If the dump produces a formatted output, 
scan the LUB, PUB, CHANQ, PIB, and 
ERROR O. (Refer to chapter 3 in this 
section for a description of these supervisor 
tables.) 

C. Locate SYSCOM (address of SYSCOM is 
found at location X'80-83' of low address 
storage). 

D. Locate the logical transient area. The 
address of the LTA is found at XT C of 
SYSCOM. 

Convert the first eight bytes of the LTA to 
characters. This is the name of the transient 
in the LTA at the time the dump was taken. 
If it is a user-written transient, obtain a 
listing of the transient and check for the 
use of SVC 22 (Seize System). When the 
system is seized, no interrupts can occur 
until a second SVC 22 is issued to release 
the system. If the transient is supplied by 
IBM, inform IBM and have the following 
available: 

Supervisor Listing, Stand-alone dump, 
Jobstream, Program Listing, Linkage Editor 
maps, and SYSLOG output. 



Recommendations to Aid 
Further Problem Analysis 



• If the error cannot be isolated, re-run the 
program with SDAID IF trace function. Use 
FASTREC output class and specify as large 
an area as possible for SDAID (refer 
to section 2-B-10). 

Proceed to check 2. 



— Check 2 — 

Analyze the 
SDAID output 



Use the SDAID IF trace output to determine 
where the LPSW (load program status word) 
was given. The HARD WAIT is caused by a 
LPSW instruction that can be issued only 
when the system is in the supervisor state. 
For example, LPSW can be issued by the 
DOS/VS supervisor or any IBM routines that 
run in supervisor state. 



Compare the last few instruction addresses in 
the IF trace output with, for example, the 
supervisor listing, or if the instruction 
addresses are not in the supervisor area, the 
listing of the IBM routine which was running 
in supervisor state. Determine the routine in 
which the LPSW is issued. 

Inform IBM and have the following informa- 
tion available: 

• SYSLOG output 

• List of the IBM routine in which the LPSW 
instruction is issued, for example, the 
supervisor listing 

• Stand-alone dump output { 

• SYSVIS dump or a copy of the PDS on 
tape or disk 

• SDAID IF trace output. 
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Check 



Check 1 



Establish task(s) 
waiting for input/ 
output interrupts 



Method of Analysis 



Use the stand-alone dump output to locate 
the PIB. Make a note of the flag byte and 
address of the partition save area for each 
entry in the PIB. (How to locate the PIB and 
analyze information contained in an entry is 
described in Chapter 7 in this Section.) 



Recommendations to Aid 
Further Problem Analysis 



Proceed to check 2. 



Check 2 



Determine status of 
the partitions 



B. 



Determine the status of each partition by 
analyzing the flag byte. For example, a 
flag byte containing X'82' indicates that 
the task is waiting for an input/output 
interrupt. 

Locate the partition save area of each 
partition and make a note of the return 
PSW in each of the save areas. (Refer to 
chapter 1 1 in this Section.) 



Use the instruction address part of each 
return PSW to locate the instruction (in the 
dump) which will be executed when the 
partition regains control. If the sequence of 
instructions in the dump starting at this 
instruction is TM, BO, SVC 7, proceed to 
check 3. Otherwise go to check 4. 



Check 3 



Analyze the contents 
of general purpose 
register 1 






Determine if the contents of general purpose 
register 1 in the partition save area is pointing 
to a CCB. An example of a valid CCB is shown 
in Chapter 5 in this Section. 



If GR 1 is not pointing to a valid CCB proceed 
to check 4. 

If the contents of GR1 is pointing to a valid 
CCB, analyze the contents of bytes 2, 3, and 
1 2 of the CCB. (Refer to Chapter 5 in this 
Section for a description of the format and 
contents of the CCB). 

If the CCB is posted, check the seek address 
and unit check bits in the CCB. If you are 
using user-written unit check procedures, 
check that the sense data is properly tested. 

If the CCB is not posted, the device using this 
CCB is waiting for an input/output interrupt. 
Go to check 5. 



Check 4- 



Analyze the program 
or programs running 
when the wait state 
occurred. 



Use the program listing and linkage editor 
map* for each of the programs that were 
running, and, in conjunction with the instruc- 
tion address part of the return PSWs in the 
associated save areas, locate the instruction in 
each of the programs. 



*lf the program has been link-edited using the 
DOS/VS relocating loader option, the re- 
location factor must be calculated based on 
the start address of the partition used for the 
program when it failed. 



Determine the routine that was being executed 
in each of the programs running when the wait 
state occurred. Check the instruction coding in 
each routine for the correct use of macros, for 
example, the use of ENQ, DEQ, and WAITM 
macros. (A task may be waiting for a particular 
resource, or there may be acprogrammed WAIT 
for a timer control block.) 

If the track hold facility is supported, check 
that the maximum number of tracks specified 
in the TRKHLD parameter is not exceeded. 
Also ensure that one task is not waiting for 
tracks held by another task. 

For details about these macros and their for f^a 
mat refer to the IBM publication DOS/VS 
Supervisor and I/O Macros, and for examples 
of the use of these macros and multitasking, 
refer to the DOS/VS System Management 
Guide. 

If the error can not be isolated, proceed to 
Check 5. 
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Soft Wait 

CHART 05, PART 2 OF 2 
Check 

Check 5 — 



Analyze the last 
START I/O 



Method of Analysis 



Inspect the channel bucket and analyze the 

contents to obtain information about the last 

input/output operation started on each 

channel. 

(Refer to Chapter 3 in this Section.) 



Recommendations to Aid 
Further Problem Analysis 



Proceed to check 6. 



Check 6 

Determine the I/O 
device involved 




A. Locate the associated PUB entry to 
determine the device address. (Refer to 
Chapter 3 in this Section.) 

B. Lo cate the associated LUB entry, (via the 
JIB if necessary), to determine the logical 
unit involved. 

(Refer to Chapter 3 in this Section.) 



Proceed to check 7. 



Check 7- 



Establish if there are 
other requests for the 
same device or if the 
CHANQisfull 



• Locate the channel queue, and check if any 
other input/output requests are queued for 
the same device. 

• Check the contents of FLPTR, if it is 
X'FF' the CHANQ is full. This may be an 
indication that the CHANQ is too small for 
the type of programs in use. 

(Refer to Chapter 3 in this Section.) 



Proceed to check 8. 



X. 



jj 



-Check 8 



Inspect the ERROR 
QUEUE 



Locate the error recovery block and check if 
there are any entries in the error queue for 
the device. 

From the error queue entry you can obtain 
the SSW, CCB address, and Message Code. 
Use the message code to locate the meaning 
and possible cause of the message by referring 
to the DOS/VS Messages manual. 
(Refer to Chapter 3 in this Section.) 



If the error can not be isolated, inform IBM 
of the problem, and have the following 
information available: 

• SYS LOG output 

• Stand-alone dump 

• SYSVISdumpor copy of the PDSon tape 
or disk 

• Job stream 

• Description of system environment and 
conditions under which the program is 
executed. 

Otherwise make corrections to your program 
as necessary. (This may require a new 
assembly of the supervisor, or re-running 
the program using a supervisor that can 
accommodate the required input/output 
operations.) 



c 
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Check 
Check 1 



Approximate location 
of the loop 



Check 2 



Eliminate 
components 






Check 3 

Preparation for 
problem analysis 
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Method of Analysis 




Use the trace of the loop (SDAID BR trace 
output or manual trace) and any notes made 
by the operator to inspect the path made by 
the loop. Also, use the linkage editor map and 
stand-alone dump to check if the loop 
addresses are within the DOS/VS supervisor 
or in the POWER/VS partition (if POWER/VS 
was initiated when the malfunction 
occurred) or in a module used by the 
program. 



• Is the loop in a user written module? 



Yes 



'Are any other programs using the same 
module? I 



Yes 



• Did these programs that use this common 
module generate unintended loops? 



A. If the loop is in the program, use the pro- 
gram listing, the trace of the loop, stand- 
alone dump, and program logic charts for 
analysis. 

B. If the module is suspected of causing the 
loop, use the listing and logic charts of the 
module for analysis. 



Also, check if any changes have been applied 
to the module since the last time the program 
ran successfully. 



No 



No 



No 



Yes 



Unintended Loop 
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Recommendations to Aid 
Further Problem Analysis 



If the loop is entirely within the DOS/VS 
supervisor or the POWER/VS partition or 
in an IBM module used by the program or 
in an IBM written program, inform IBM 
and have the following system information 
available: 

• SYSLOG log sheet 

• Any output from the program 

• Job stream 

• Trace of the loop (SDAID output 
if possible) 

• Stand alone dump 

• SYSVIS dump, or copy of the PDS 

• DOS/VS supervisor listing and the 
POWER/VS listing (if applicable) 

If the loop is not in the suppervisor or the 
POWER/VS partition, or only part of it 
is, proceed to check 2. 



Loop is caused by the program. Proceed to 
check 3. 



Suspect the module of causing the loop. 
Proceed to check 3. 



Loop is very likely generated by the module. 
Proceed to check 3. 



Proceed to check 4. 



Remove the changes and re-run the program. 
Otherwise, proceed to check 4. 



Check 4 



Program and problem 
analysis 



Check program listing and logic flow for: 

• Count locations that can never reach 
their limits. 

• Counters that are not updated. 

• Counters that are never initiated. 

• Count locations, the contents of which 
are not periodically or properly tested. 

• Check that I/O operations are able to 
reach their completion, and are not 
prevented from doing so by program 
logic. 

Check the counter locations in the stand- 
alone dump. They may have been over- 
written, in which case use the program 
listing to isolate the point in the program 
where the locations are prepared. 
Note: Examine the channel programs if I/O 
operations are directly responsible for 
preparing count lacations. 



-If error cannot be isolated, re-run the program 
using SDAID BR and/or IF trace functions to 
obtain a complete trace of program and 
module logic flow during program execution. 
(Refer to Section 2-B-10.) 

Also, use PDAUD F/L trace to check phases 

used by the program. (Refer to Section 2-B-4.) 

Re-analyze the problem. 

If the error can not be isolated, inform IBM. 

Have the following system information 

available: 

• SDAID output 

• SYSLOG output 

• Job stream 

• Program listing 

• Listing of module used (if module suspected) 

• Trace of loop 

• Stand-alone dump 

• SYSVIS dump or copy of PDS on tape or 
disk 

•SHJDAID output. 
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Incorrect Output not immediately detected 

CHART 07, PART 1 OF 1 

Check Method of Analysis 

Check 1 



Gather any information 
pertaining to program 



Recommendations to Aid 
Further Problem Analysis 



~\ 



A. Ascertain System Environment (Super- 
visor, DOS/VS release number, I/O 
devices used, modules used, etc.) 

B. Obtain SYSLOG output from the job, and 
if possible the input job stream and input 
files. (This depends on many circum- 
stances, such as time involved, storage of 
output from previous runs, original input 
files already overwritten for other jobs 
etc.) 

C. Program listing and linkage editor map. 



D. Ascertain the status of the machine at the 
time the job ran. For example, find out if 
an I/O unit in use for the program 
developed an error and analyze its effects 
on the program. 



Turn to check 1 of chart 06 and analyze the 
problem using all available information. 
Try to simulate the same conditions for a 
re-run of the program. 
Use chart 06 for error isolation. 



Re-run program; execute a system dump 
or stand-alone dump when incorrect output 
is detected. 
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Check 



Method of Analysis 



Incorrect Output detected during Program execution 

CHART 08, PART 1 OF 5 

Recommendations to Aid 
Further Problem Analysis 






Check 1 



Environment 



Was the program operating under POWER/VS 



-Check 2 



Type of program 
producing the 
incorrect output 



■c 



Check 3- 

Type of incorrect 
output 



Yes 



No 



Userwritten? 



IBM-supplied program? 
Assembly language compiler 

High level language compiler (RPG II, 
FORTRAN, etc.) 

IBM library program (DSERV, SORT/ 
MERGE) etc. 



Use any output from the program and 
messages printed during program execution 
to determine the type of/incorrect output 
according to the following categories: 



• Duplicate (identical lines printed). 



Lack of (missing data printed). 



• Too much or unexpected (more data printed 
than expected). 



Turn to chart 13. 



Proceed to check 2. 



Proceed to check 3. 



Inform IBM and have the following informa- 
tion available: 

• All output from the program 

• SYSLOG output 

• Job stream 

• Input files 

• Supervisor generation notes and level of 
release 

• Listing of the support for the failing 
program 

• Notes about system type and model, and 
any notes about system status and input/ 
output units used for the program. 



Use the program listing and analyze the 
coding, checking for: 

• Unnecessary program loops in input/ 
output routines 

■•Routines not being entered or completed 

• Overlaid input/output areas. 

If necessary, re-run the program using 
SDAID IF, SA, and GA trace functions. 
Specify event limits that will adequately 
cover routines that prepare output areas. 
(Refer to section 2-B-10.) 
Re-analyze the output from the re-run. 
If the error can not be isolated proceed to 
check 4. 



o 



Debugging for Programmers, part 1 . 4.13 



Page of GC3 3-5 38 0-1, 
revised September 30, 1974, 
by TNL GN33-8793 



Incorrect Output detected during Program execution 

CHART 08, PART 2 OF 5 

Check Method of Analysis 



Check 4 



System condition 
during program 
execution 



Check 5 



Job stream 



Were there any abnormal interruptions in 
computer operations during execution of the 
program? 



Yes 



No 



Were any abnormalities observed in system 
actions or response to messages by the 
operator during program execution? 



Yes 



No 



Check that the correct job stream was used for 
the program. This applies also to job streams 
cataloged on the procedure library. 
(Use PSERV to display the procedure 
library; refer to section 2-C-3.) 



Recommendations to Aid 
Further Problem Analysis 



Analyze the possible effects of any interrup- 
tion, and re-run the program ensuring no 
interruptions. 



Re-run the program and note any unex- 
pected system actions. Ensure the correct 
response is given to messages issued. (Refer to 
the DOS/VS Messages manual). 
Use any notes made to analyze program logic. 
If necessary, re-run the program using with 
the SDAID IF trace to aid analysis of pro- 
gram logic. 
Check the input used for the program. 

Proceed to check 5. 



If error isolated, make corrections as 
necessary and re-run the program. 

If error can not be isolated, proceed to 
check 6. 






Check 6 



Input used 



A. Isolate suspected areas on the input files 
by examining the output from the program. 
For example, a missing record in the 
output indicates the approximate area on 
the input file that may be in error. 



B. Check the labels and volume ID and extent 
information. Use LSERV and LVTOC, or 
for VSAM files use LISTCAT Access 
Method Services utility commands. 



A. Obtain a dump of suspected areas on the 
input files used. For VSAM files use the 
Access Method Services utility program 
PRINT command. (Refer to section 2-C). 

B. Check input/output file macro 
definitions in the program listing against 
characteristics of data on the input files. 
DTF (LIOCS), CCB (PIOCS) 

ACB, RPL, and GENCB (VSAM). 

Compare the output of the LSERV, LVTOC, 
and LISTCAT programs with DLBL/EXTENT, 
VOL ID, data in the job stream. 
If no errors can be found, proceed to check 7. 
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Check 



Check 7 



Dump of partition 



Method of Analysis 
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Recommendations to Aid 
Further Problem Analysis 

Yes 



Did the operator obtain a dump of the 
partition containing the failing program? 
For example, a stand-alone dump, a system 
dump, or a dump obtained by using the 
DUMP command. 



Inspect input/output areas in the dump, also 
inspect CCBs and channel programs. (Refer to 
chapter 5 in this section.) 
If no errors are found proceed to check 8, or 
if satisfied with the information that can be 
obtained from the dump go to check 10. 



No 



Proceed to check 8. 



Check 8 

Obtain a non- 
destroying dump 






Use the program listing and the information 
already obtained from the previous analysis 
of the problem to isolate the approximate 
area of the failure. 

For example, a specific input/output area, 
or a specific work area. 



-A. Re-run the program with SDAID IF and/or 
SA trace function. Specify a stop on event 
and obtain non-destroying dumps at specific 
instructions, or specific storage alterations. 
(Refer to section 2-B-10.) 

B. Also, as a further aid for problem analysis, 
use the PDAID F/L trace to trace phases 
used by the program. 

Proceed to check 9. 



Check 9 



Analyze the SDAID 
dump output 



A. Inspect input/output areas, CCBs, and 
channel programs in the non-destroying 
dump output. 

B. Compare input/output areas as defined 
in the DTFs, CCB and CCW macros, and 
ACB, RPL and GENCB macros in the 
program listing, with the areas as printed 
in the dump. 

C. Check the sequence, names, and load/ 
entry addresses of the phases used by the 
program, and compare them with the 
linkage editor map addresses. 

D. Use the program listing and dump output 
to inspect values in registers and storage 
locations used for intermediate results. 



If no errors can be found and the cause of the 
error can not be isolated, proceed to check 10. 



Debugging for Programmers, part 1 . 4.15 



Incorrect Output detected during Program execution 

CHART 08, PART 4 OF 5 

Check Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Check 10 



Unusual conditions 
generated by the 
program and its input 



Check that the program logic and counters can 
accommodate unusual conditions and circum- 
stances of input. For example, data changes 
(year), or extraordinary changes in amounts 
and quantities. 



If the error can not be isolated, proceed to 
eheck 1 1 . 



Check 11- 

Preparation of the 
input files 



Check the input used for this program. If 
necessary, analyze the program that prepared 
the input files, starting at check 1 of this 
chart. 



If the input is correct, and the program that 
generated the input is not at fault, proceed 
to check 12. 



Check 12 



Gather more system 
information 



Re-run the program, using, if possible, newly 
prepared input data that is known to be correct 
Try to simulate or run under identical condi- 
tions to those in which the failure occurred. 



Re-run the program with the PDAID F/L 
trace, to trace phases used by the program. 
(Refer to Section 2-8-4.) 
If you have not carried out the recommen- 
dations listed in checks 8 and 9 of this 
chart, initiate the SDAID IF, and/or SA 
trace functions. Use specific addresses for 
the event limits that are related to the 
problem, based on your previous analysis. 
(Refer to Section 2-B-10.) 
Before re-running the program, re-assemble 
it using the PDUMP macro to dump all 
input/output areas before and after every 
input/output operation. 
(Refer to Section 2-A-5.) 

If the program is using VSAM files, re- 
assemble the program and insert the 
TESTCB or SHOWCB macros, before 
and after each OPEN, GET and PUT. (Refer 
to Chapter 4 in this Section.) 

If, after re-analysis of the problem using the 
output from the re-run, the error can not be 
isolated, inform IBM and have the following 
information available: 

• All program output, whatever it is 

• All dump output 

• SDAID/PDAID output 

• SYSLOG output 

• Job stream 

• Any notes pertaining to the problem 

• Notes about system environment and 
condition. 



K^j/ 
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Check 

Check 13 

Eliminate 

components 

used. 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



• Without initiating a POWER partition or 
running under POWER RJE re-run the 
program producing the incorrect output. 



Are other programs generating incorrect 
output when running under POWER or 
POWER RJE 



3 



If program still generates incorrect output, 
analyze the problem starting at check 1 of chart 
06, part 1 . Otherwise suspect the POWER or 
POWER RJE partition and proceed to check 14 



Yes 



Proceed to check 14 



- Check 14 — r 
Programs falling 
which run under 
control of POWER 
or POWER RJE 



Inspect the contents of general purpose register 
7 printed at the beginning of a system dump or 
stand-alone dump executed just before the 
malfunction occurred. This register should 
contain the address of the TIB of the active 
POWER or POWER RJE routine just before the 
dump was executed. 






If the program is run under POWER consult 
Appendix K, or if run under POWER RJE 
Appendix L. 

By using the system information and Appendix 
K or L (as applicable), you may be able to 
isolate the cause of the error. In any case it is 
recommended that you inform IBM of the 
problem and have the following information 
available: 

• SYSLOG output 

• Stand-alone dump 

• A dump, or copy of SYSVIS 

• Dump of the QFILE 

• Supervisor assembly listing 

• POWER SCP assembly listing 

• Job stream 

• Any notes made during system operation 
when the malfunction occurred. 

You may re-run the program under POWER or 
POWER RJE with the following aids. 

A. Use PDAID I/O or QTAM trace functions to 
trace I/O operations on all units used by the 
program producing incorrect output, and by the 
partition owning POWER/POWER RJE. (Refer 
to section 2-B-4). 

B. Use SOAID BR function on the partition 
owning POWER to trace the logic flow during 
program execution (Refer to section 2-B-10). 

C. As an option, re-run the program using 
PDAID F/L trace on the partition owning 
POWER to trace phases used. (Refer to section 
2-B-4). 



o 
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Check 



Check 



Method of Analysis 



Type of 
cancellation 



H 



Program Check. 



Illegal SVC. 



Program canceled by Program Check 

CHART 09, PART 1 OF 4 

Recommendations to Aid 
Further Problem Analysis 

Proceed to check 2. | 

Turn to chart 10. 



Other (for example, operator cancel lation). }*-^^'l Turn to chart JT 



Check 2 



Area of failing 
instruction 
(Level 1) 



Is message 1Q30D ABNORMAL 

POWER/VS TERMINATION. 

PRINTER^ 

issued on SYSLOG just after 

the program check message? 



No 



Is the program check in the SVA? 
There are two methods to establish this: 

1 . From the MAP command output check if 
the instruction address shown in the Program 
Check message is within the SVA. 
(The MAP command should have been issued 
by the operator immediately after the Program 
Check occurred) 

2. If a System Dump was executed when the 
Program Check occurred and the Program 
Check was in the SVA, a dump of the SVA (or 
part of it) will be preceded by the following 
message printed in the dump output: 

PART OF SVA WHICH CAUSES ERROR 






X 



Check 3 — 

Area of failing 
instruction (Level 2) 



No 



Use the load and entry addresses of phases and 
modules used by the program as indicated on 
the linkage editor map,* and the error message 
to locate in which area the program check 
occurred: 



[ * Program check in user program area 



►Program check within the supervisor area 
(The address of the end of the supervisor is 
contained in bytes X'20'-X'23' of SYSCOM 
and the address of SYSCOM is contained in 
bytes X'80'-X'83' of the low address storage.) 



•Program check within the partition 
containing the POWER/VS SCP or 
POWER RJE system control programs 



Check 4 



Location of failing 
instruction 






Use the linkage editor map as in check 2 above, 
to determine whether: 

• the program check is within the user-written 
program, 

• or in a user-written module used by the 
program. 

Note: 

If the program check is within an IBM-supplied 

module used by the program, and no system 

dump was executed when the program check 

occurred, re-run the program with the 

// OPTION DUMP statement in the job stream. 

(Refer to Section 2-A-2) Otherwise inform IBM 

and have the following information available; 

• SYSLOG output 

• Job stream 

• System dump output 

• Program listing and linkage editor map. 



This indicates the program check occurred 
within the POWER/VS partition. 

Turn to chart 13, check 5. 



Yes 



If a System Dump was executed, you may be 
able to isolate the error by using the information 
already available to you. If this is the case, go to 
check 1 3 on part 4 of this chart. 

If a System Dump was not executed, it will be 
necessary to re-run the job and include the 
,/ OPTION DUMP statement in the job stream 
before going to check 13 on part 4 of this chart. 
Also initiate the SDAID dump on event Program 
Check (refer to Section 2-B-10) and if your 
system suports PDA ID, initiate a FETCH/LOAD 
trace to trace the phase being loaded in the 
SVA. (Refer to Section 2-B-4). 



■^► j Proceed to check 3 




Proceed to check 4. 



Turn to chart 1 2. 



Turn to chart 1 3. 



Proceed to check 5. 



*lf the program has been fink-edited using the 
DOS/VS relocating loader option, the re- 
location factor must be calculated based on 
the start address of the partition used for the 
program when it failed. 



Debugging for Programmers, part 1 . 4.19 



Program canceled by Program Check 

CHART 09, PART 2 OF 4 
Check 



Method of Analysis 



Check 5 

Analyze failing 
instruction and 
type of program 
check 



Can the cause of the failure be isolated using 
the program listing, error messages, and job 
stream? 



Yes 



No 



Recommendations to Aid 
Further Problem Analysis 



Make correction as necessary and re-run the 
program. 



^^\ Proceed to check 5. 



Check 6 



Dump of 
partition available? 



Was a system dump executed when the 
program check occurred? (System dump is 
described in Section 2-A-2). 



Yes 



No 



Proceed to check 7. 



Re-run the program with // OPTION DUMP 

statement in the job stream. 

Also, use the SDAID stop-on-event program 

check and obtain a non-destroying dump. 

(Refer to Section 2-B-10.) 

When you have obtained the dumps 

continue problem analysis from check 7 of 

this chart. 



Check 7- 

Analyze dump of 
partition (Level 1 ) 



Use error messages, linkage editor map*, and 
program listing to locate failing instruction in 
the Dump. 
(An example is shown in Section 2-E-3.) 



If the instruction and code appears correct 
and has a valid operation code and data 
field, proceed to check 8. 
If the program check message indicates an 
error in input/output operation in your 
program, go to check 10; otherwise proceed 
to check 8. 



V=> 



Check 8 — 

Analyze dump of 
partition (Level 2) 



Locate the partition save area and inspect 
the contents of general purpose registers. 
(The location and format of partition save 
areas are described in Chapter 1 1 of this 
Section.) 



Use program listing, and linkage editor 
map* to locate data areas in the dump used 
by the failing instruction. 



*lf the program has been /ink-edited using the 
DOS/VS relocating loader option, the 
relocation factor must be calculated based on 
the start address of the partition used for the 
program when it failed. 
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Look for unreasonable or totally unexpected 
values in the general purpose registers. If you 
find any that are connected to the failing 
instruction, locate the code in the program 
listing responsible for preparing the register(s). 
(General register usage is described in 
Chapter 9 of this Section.) 
If the cause of the error can not be isolated, 
proceed to check 9. 



Depending on the type of program check 
indicated by the error message, inspect data for 
validity, duplication, missing information, and 
sequence errors. 

If the cause of the error cannot be isolated, 
proceed to check 9. 



O 



Check 



Method of A na lysis 



Check 9- 



Analyze the general 
register and data 
preparation 
instructions 



Inspect the program logic and instructions 
responsible for preparing the general 
registers and data areas used by the failing 
instruction. 
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Recommendations to Aid 
Further Problem Analysis 



If an input/output operation is involved, 
proceed to check 10; otherwise, go to check 1 1 



Check 10- 

Analyze the input/ 
output operation 



Locate and inspect command control blocks 
(CCBs) and channel programs in the system 
dump as described in Chapter 5 in this Section. 
Note: to locate and analyze CCBs and channel 
programs for programs using VSAM 
files, consult the description given in 
Chapter 4 in this Section. 



If it is an input operation, and this input is used 
to prepare the general registers or data fields 
used by the failing instruction, you may suspect 
the program that produced the input. 
Proceed to check 1 1 , or first analyze the 
program that provided the input to this program 
by following the recommendations given in 
charf08 (incorrect output). 



Check 1 1 



Prepare a program 
re-run to gather more 
detailed system 
information 






Use SDAID SA and/or GA trace functions if 
you suspect that data of general register 
alteration is the cause of the error. Specify 
address limits on the suspected areas 
calculated from the start of the partition in 
which the program is re-run. Refer to Section 
2-B-10.) 
Note: the SA trace can not be used to trace 

areas altered directly by input/ 

output operation. 
If the logic flow of the program during 
execution is in doubt, use the SDAID BR 
trace function on the partition in which the 
program is re-run. 



B. If the program is running in virtual mode or 
using user written channel program 
translation routines, use SDAID stop-on- 
event program check and obtain a non- 
destroying dump. (See note) 

(Refer to Section 2-B-10.) 

C. If the program is running in virtual mode 
and using the IBM-supplied channel pro- 
gram translation routine, check that your 
program is not violating the rules for 
channel program translation support. 



Proceed to check 12. 



Check the general rules applicable to channel 
program translation routines. (Refer to 
Chapter 13 in this Section.) 



Note: The SDAID non-destroying dump 

enables you to analyze the CCB/CCW 
copy blocks and the CCW/TCB in 
the supervisor area. Note that these 
blocks may be overwritten by the 
system dump when analyzing the 
output from a system dump. 
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Check 12 

Re-analyze the 
output from the 
program re-run 



Use all the information obtained from the re-run 
and re-analyze the problem. If the error cannot 
be isolated, you may either inform I BM or re- 
assemble the program, inserting one or more of 
the following assembly macros in your 
program. Then re-run the program. 



• PR INT GEN (to obtain an expansion of all 
macros in used by the program). 

• PDUMP (to obtain the dumps of selected 
areas of storage, such as input/output areas, 
during program execution. Refer to Section 
2-A-5) 

• DUMP or JDUMP (to obtain a dump of 
partition and supervisor at a point in the 
program before the program check occurs. 
Refer to Section 2-A-5.) 



If you choose to inform 


IBM, 


have the 


following information available: 




*SYSLOG output 








• Job stream 








• SDALD output 








• Program listing and I'm 


kage 


editor 


map. 



Re-analyze the problem using output obtained 
from the re-run. Examine the expansions of 
macros used by the program and check the 
DTF macros used for file definition with the 
program listing. 

If the error can not be isolated, inform IBM 
and have all information obtained from program 
re-runs, plus any notes made of your previous 
analysis. 



Check 13 



Analyze dump 
of the SVA 



A. If it is known which program or phase 
in the SVA caused the program check, 
use error messages and program listing 
to locate the failing instruction in the 
dump. (An example is shown in Section 
2-A-2of this manual). 

B. If the name of the phase in the SVA 
that caused the program check is not 
known, use the PDAID FETCH/LOAD 
trace output to locate the last phase 
used by the program. 

The load address of the phase should be 
the start address of the SVA printed in 
the dump. 



Compare the hex code of the failing 
instruction given in the assembly listing 
with the hex code in the dump output. 
If the instruction and code appears to be 
correct and has valid operation code and 
data fields specified, continue problem 
analysis from check 8 on part 2 of this 
chart. 

If the program check message indicates an 
error in I/O operations, continue problem 
analysis from check 10 on part 3 of this 
chart. 



//""""N 
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Program canceled by Illegal SVC 

SUPPORT FOR CHART 10 



The complete text for message OS04I is: 

ILLEGAL SVC- HEX LOCATION nnnnnn - SVC 
CODE nn 

where nn is in hexadecimal notation. 

This message results from the following causes: 

1. When nn is 02: The phase name given does not start with 
$$B,or 

For LIOCS, macros called in invalid sequence. As a result, 
on SVC 8 is issued after an SVC 2 before an SVC 9 has 
been issued to free the transient area, or 

For other conditions, the user specified a temporary exit 
(SVC 8) for a logical transient. In the temporary exit 
routine, another routine is called (by an SVC 2) before 
an SVC 9 is issued to free the transient area. 

2. When nn is 05: The 'to' range specified in the MVCOM 
macro is invalid. 

3. When nn is 0A, 1 2, 1 3, or 1 8: The supervisor was 
generated without the timer option. 

4. When nn is OB: The call was not given by a logical 
transient routine. 

5. When nn is 1 6, 1 7, or 1 A: The caller did not have a PSW 
key of zero. This is applicable only in a multiprogramming 
system. 

6. When nn is 23: More than 16 holds have been issued for 
the same track. 

7. When nn is 24: Free a non-DASD or a track that is not 
held. 

8. When nn is 26: A subtask issued attach, or the save area 
is not on a doubleward boundary. 

9. When nn is 27: A main task issued detach without 
SAVE = parameter, or 

A main task issued detach, but the ID of the subtask in 
the save area passed is not valid, or 

A main task attempts to detach on already terminating 
subtask. 

10. When nn is 29: A DEQ is issued by a task that did not 
ENQ the resource. (This is valid in an AB routine.) 



1 1 . When nn is 2A: A subtask (without an ECB = parameter) 
has issued an ENQ macro, or 

A subtask has issued an ENQ macro to a resource that 
has not been dequeued by another task that has been 
terminated, or 

A task has issued two ENQ macros to the same resource 
without an intervening DEQ. 

12. When nn is 2D: Emulator execution was attempted, but 
the EU parameter of the SUPVR macro was omitted or 
incorrectly specified during system generation. 

13. When nn is 32: For LIOCS: 

a. An imperative macro (such as WRITE or PUT) was 
issued to a module that does not contain the 
requested function, or 

b. A PUT was issued for an ISAM retrieve module 
without a preceding GET, or 

c. An invalid ASA first character for the printer 
was used, or 

d. A wrong length record indication occurred while 
processing 1287 documents when 
RECFORM=UNDEF,or 

e. The 1287 program erroneously contained a CCW(s) 
with the SLI flag bit 'OFF', or 

14. When nn is any other value: The supervisor function 
requested by the operand of the SVC is not defined 
for the supervisor being used. 



^> 






Causes for Message 0S04I (Cancel Code X'21') 



^L_j^ 
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Check 



Check 1 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Supervisor support for 
the SVC code printed 
in the error message 



Use the supervisor listing to check if the option 
used by the SVC is supported. For example, 
SVC X'43' must be supported by a supervisor 
generated with PFIX = YES. 



Compare the SVC code printed with the list of 
SVCs given in Chapter 6 of this Section. 



If the option is not supported, avoid the use 
of the SVC by the program, or re-assemble 
the supervisor, or re-run the program using 
a supervisor that supports the option. 



If the SVC code printed in the error message is 
not listed, go to check 3. 
Use the figure opposite to isolate possible 
causes of error if the error message is 0S04I. 
If the option is supported and no reason can be 
established for the error, proceed to check 2. 



Check 2 

Location of SVCs 
issued by the program 



Use the program listing and linkage editor map* 
to locate where the SVC is issued. 
Note: To ensure that all SVCs issued by the 
program are checked, use a program listing 
that shows the expansions of the macros used. 
(If such a listing is not available, you will have 
to re-assemble the program with the 
PRINT GEN assembly control statement.) 



Check the sequence of SVCs issued and macros 
used to ensure that the program is written to 
enable correct use and sequence of SVCs. 
If there is any doubt about the sequence of 
SVCs issued by the program, re-run the 
program with the PDAID GSVC trace. (Refer 
to Section 2-B-4.) If the error can not be 
isolated, proceed to check 3. 






Check 3 — 

Dump of partition 



Was a System dump taken when the program 

check occurred? 

(System dump is described in Section 2-A-2.) 



No 



Re-run the program with the // OPTION DUMP 
statement in the job stream, or initiate the 
SDAIDdumpon event program check (refer 
to Section 2, B-10-F). 



Yes 



Proceed to check 4. 



Check 4 



Analyze the dump 



Use the program listing, error message, linkage 
editor map*, and system dump to locate the 
SVC instruction in the dump. 



If the program has been link edited using 
the DOS/VS relocating loader option, the 
relocation factor must be calculated based on 
the start address of the partition used for 
the program when it failed. 



o 



Compare the hexadecimal code for the SVC in 

the dump with the SVC instruction in the 

program listing. 

If there are differences, analyze the program 

to isolate the point where the correct SVC 

instruction is overwritten. 

As a further aid in this analysis, you may need 

to re-run the program with the SDAID SA 

trace. Use the STOP ON EVENT option and 

obtain a non-destroying dump at the point 

suspected of causing the overwriting. 

If there are no differences and the error can not 

be isolated, inform IBM and have the following 

ingormation available: 

• Supervisor listing 

• Program listing, including the macro 
expansions 

• Linkage editor map 

• System dump 

• SYSLOG output 

• Job stream. 
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Check 



Check 1 — 

Reason for program 
cancelation 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Did the operator cancel the program? 



Yes 



Inspect messages printed on SYS LOG and 
SYSLST prior to the cancelation. If necessary, 
interview the operator to establish system 
activity during program execution. (It is possible 
that incorrect response to messages issued during 
program execution caused an unusual condition 
to occur.) 
Proceed to check 2. 



No 



Examine the program listing and check for 

the use of DUMP or CANCEL macros left in 

the program from testing phases (program 

testing). 

Remove these macros and proceed to check 2. 



Check 2 



Re-run the program 



Re-run the program. If possible, be present 
during the re-run to observe system activity. 
Follow the recommendations given in DOS/VS 
Messages manual, and ensure the correct 
response is given to messages issued during 
program execution. 

Ensure the use of the //OPTION DUMP state- 
ment in the job stream, to obtain a system dump 
when the program is canceled. (Refer to 
Section 2-A-2.) 



If the identical error recurs, it may be due to 
the incorrect use by the program of an IBM- 
supplied routine. 

Inform IBM and have the following information 
available: 

• SYS LOG output 

• SYSLST output 

• System dump output 

• Job stream 

• Program listing and linkage editor map. 
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Check 



Check 1 



Approximate the area 
where the program 
check occurred 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Is the program check within the logical 
transient area? (Message 0S08I followed by 
message 0S1 1 1 will inform you where the 
instruction address, (the program check 
occurred) is located. 



No 



Go to check 8. 



Yesr 



Proceed to check 2. 



Check 2 



Dump available? 



Was a system dump executed at the 
occurrence of the program check? 
(Refer to Section 2-A-2.) 



No 



Yes 



Re-run the program with the //OPTION DUMP 
statement in the job stream. Also, initiate the 
PDAID transient dump program, described in 
Section 2-A-4, or use the SDAID stop-on-event 
program check function and obtain a non- 
destroying dump. (Refer to Section 2-B-10.) 
After the re-run, go to check 4. 



Proceed to check 3. 



o 



Check 3 



Analyze the system 
dump to determine the 
name of the logical 
transient 



Use the system dump to locate the partition 
save area. (Refer to Chapter 12 in this Section.) 
Locate the return PSW in the save area and 
determine the failing instruction address. 
Locate this address in the dump and go two 
bytes to the left. 

Is the contents of these two bytes X'0A02' 
(SVC 2)? 



Re-run the program and initiate the PDAID 
transient dump program as described in 
Section 2-A-4, or use the SDAID stop-on-event 
program check function and obtain a non- 
destroying dump. (Refer to Section 2-B-10.) 
(Also include the //OPTION DUMP statement 
in the job stream to obtain a system dump.) 
Proceed to check 4. 



Locate the general purpose register 1 in the 
save area. This consists an address. 
Locate this address in the dump and convert 
the first 8 bytes, starting from this address, to 
characters. This is normally the name of the 
logical transient fetched by the program. 
(For OPEN or CLOSE register 1 may point 
to the DFT). 

Note: The cause of the program check need not 
necessarily be in this transient, since a logical 
transient may need to fetch another transient 
to complete a service. The program check 
could therefore be caused by incorrect para- 
meters being passed to the transient. 
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Check 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Check 4 



Determine the 
name of the logical 
transient fetched 



Use the PDAID transient dump output to 
determine the name by converting the first 
8 bytes of the dump to characters. (Refer to 
the example of a transient dump output given 
in Section 2-A-4.) 



Use the SDAID non-destroying dump output to 
locate Byte X'1 C of SYSCOM which contains 
the address of the logical transient area. 
(The address of SYSCOM is contained in 
bytes X'80-83' of the low address storage. 
(Refer to Section 2-E-2.) 
The first 8 bytes of the LTA, when converted 
to characters, give the name of the logical 
transient fetched. 



Proceed to check 5. 



Check 5 



No 



Type of logical 
transient program 



Is the logical transient user-written? 



Use the problem program listing and the system 
to determine the routine that was being 
executed when the program check occurred. 
Then determine which macro in the routine 
was responsible for fetching the logical 
transient. For example, the OPEN macro will 
cause the logical transient $$BOPEN to be 
fetched. 

If the error can not be isolated, inform IBM and 
have the following information available: 

• SYSLOG output 

• PDAID/SDAID output (if available) 

• Job stream 

• Supervisor listing 

• Program and transient assembly listings 

• Linkage editor maps. 



Yes 



Proceed to check 6. 



Check 6 



PDAID or SDAID out- 
put available? 



To complete problem analysis you will require 
the PDAID transient dump output, or a non- 
destroying dump output from the SDAID 
program. 



If you have already re-run the program and 
obtained one or both of these dumps, proceed 
to check 7. Otherwise, re-run the program, 
following the recommendations given in check 2 
before proceeding to check 7. 
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f\ 



Check 



Check 7- 



Analyze the dump of 
the logical transient 
area 



Method of Analysis 



Program canceled by Program Check in Supervisor 

CHART 12, PART 3 OF 3 

Recommendations to Aid 
Further Problem Analysis 



Use the PDAID/SDAID output and the 
assembly listing of the logical transient fetched 
to locate the failing instruction address in the 
logical transient area. 



A Locate the general registers at the top of 
the dump. 



J 



Locate data preparation areas that are used 
by the failing instruction in the dump. 
Check the instructions in the assembly 
listing of the Logical Transient that is 
responsible for preparing data areas for use 
by the failing instruction. 



Look for unreasonable or totally unexpected 
values in the registers. If you find any that are 
connected with the failing instructions locate 
the code in the assembly listing that is 
responsible for preparing the register(s). 
If the contents of the general registers 
appear to be correct proceed to check 8. 
(General Register usage is described in 
Chapter 9 of this Section). 



Depending on the error message, inspect data 
used by the failing instruction for validity, 
duplication, and missing information. 

If the error can not be isolated, inform IBM 
and have the following information available: 

• SYSLOG output 

• PDAID/SDAID output 

• Job stream 

• Supervisor listing 

• Program and transient assembly listings 

• Linkage editor maps. 



-Check 8- 



Isolate area in the 
supervisor causing the 
program check 



Use the error message and assembly listing of 
the supervisor to determine in which routine 
in the supervisor the program check occurs. 



Before informing IBM of the problem, re-run 
the program with the SDAID stop-on-event 
program check function and obtain a non- 
destroying dump when the program check 
occurs. (Refer to Section 2-B-10.) 
Have the following information available. 

• SYSLOG output 

• Job stream 

• SDAID output 

• Supervisor listing 

• Program listing and linkage editor map. 
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Check Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



-Check 1 — 

Eliminate 
components 
(Level 1) 



Rerun the job under DOS/VS, that is do 
not run as a POWER/VS job and do not 
initiate a POWER/VS partition. Ensure 
to include the // OPTION DUMP state- 
ment in the job stream and as an option 
initiate the SDAID dump on program 
check. (For jobs entered under RJE you 
must submit the job stream and input 
data files to the central station, request 
output to be directed to a local LST 
and/or PUN.) 



If the malfunction recurs, analyze it 
using the dumps obtained as indicated 
in this section commencing at Chart 01 , 

If the malfunction does not recur 
proceed to check 2. 



Check 2 

Programs fail 
when run under 
POWER/VS only 



Has the program ever run correctly 
under POWER/VS? 



No 



Check the following. 

• Errors in JECL and device assignments. 

• Condition of spooling devices and disk 
packs. 

• The level of, and support for 
POWER/VS in the DOS/VS supervisor. 

• Storage requirements and options 
specified in your version of 
POWER/VS. 

Try to correct any obvious errors. 



Yes 



Check the following: 

• Changes in job stream JECL 

• Changes in the DOS/VS supervisor 

• Changes to data files/volumes 

© Changes to POWER/VS (regeneration 
or application of PTFs) 

• Condition of spooling devices and 
disk packs 



[ \y 



Determine if other programs are 
failing when run under the same 
version of POWER/VS. If so, contact 
the programmers concerned - they 
may have isolated the reason already. 
Proceed to check 3. 



-Check 3- 



Wait state 



Was the type of malfunction 


Yes 


Proceed to check 4 and rerun the job 
as advised in that check but 
immediately the wait state occurs 
execute a standalone dump exactly 
as described in Section 2, A-3-F. 
Then go to check 5. 


a wait state? 






No 








Proceed to check 4. 
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Recommendations to Aid 
Further Problem Aan lysis 






Chrrk A 












Eliminate 




Was the failing job entered or output via 
terminal under POWER/VS RJE ? 


Yes 


Submit job stream and data to the central 
station to be entered via local units. Request 






components 
(Level 2) 








output to a local LST and/or PUN. It is 
advisable for you to supervise program 
execution at the central station to note 














No 






system activity and avoid interruptions 






during job execution. Ensure the 






// OPTION DUMP statement is included 






in the job stream and request the control 






station to initiate SDAID dump on program 






check. After the input is spooled issue the 






PDISPLAY ALL command to obtain the 






status of ALL queues. Issue this command 






again just before the output (LST or PUN) 






tasks are started. 






In case of incorrect output the queue 






records and their associated data records 






belonging to a specified job name can be 






dumped. (See appendix L, POWER/VS 






File Dump Program.) 






• If the malfunction recurs, proceed 






to check 5. 






• If the malfunction does not recur 






inspect the RJE line used by the RDR 






input for the job stream or RJE pro- 






cessing within the POWE R/VS SCP. 






Go to check 6. 




^ 


If the error cannot be isolated by the pre- 




vious general checks, rerun the job under 




POWER/VS with the SDAID dump on pro- 




gram check initiated. Also ensure that the 


ChrrU «i 


// OPTION DUMP statement is included in 


wllcUIV %J 




You may suspect the POWER/VS SCP 




the job stream. After the input has been 
spooled issue the PDISPLAY ALL command 


POWER/VS SCP 




of causing the error. Inform the IBM 




error 




CE/SE and have the following 
information available: 
• SYS LOG log sheet 




to obtain the status of all queues. Issue this 
command again just before the output 
(LSTor PUN) tasks are started. 








• System dump) 

• SDAID dump! 




In case of incorrect output the queue 






, records and their associated data records 




• Input job stream 




belonging to a specified job name can be 




• Line printer (LST) output 




dumped. (See appendix L, POWER/VS 




• Standalone dump,} 




File Dump Program.) 




and note of low f ,, 




• If the malfunction recurs, proceed 




address storage, f 




to check 5. 




plus PDS dump ' 




• If the malfunction does not recur, no 




• PDISPLAY command output 




further analysis as to the cause of the 




• Notes on your analysis 




original failure can be done. However, 




• POWER/VS SCP assembly listing 




inform IBM and keep a record of the 






and linkage editor map 




problem and its solution. 



-Check 6— 

RJE line or 
processing 



You may suspect the RJE line used 
for job input or the processing of 
RJE under POWER/VS. 



if applicable to the type 
of malfunction. 

contained on SYSLOG 



To verify the line, re-run the 
job using the RJE I/O trace 
(See Appendix J) 

• Inform IBM and have the following 
information available." 

• SYSLOG log sheet 

• System dump } # 

• SDAID dump I 

• Input job stream 

• Line printer (LST) output 

• Standalone dump, 
and note of low 
address storage, 
plus PDS dump 

• PDISPLAY command output > 

• PINQUIRE I 
command output 

• RJE I/O trace output (in dump) 

• Notes on your analysis 
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The figure below illustrates the general organization of virtual storage. 

The supervisor is loaded in the real address area beginning at virtual address byte 0. 
Virtual storage can extend up to 16 million bytes. The figure also shows the general 
organization of the supervisor. Each area within the supervisor is described in more 
detail in this Section, except for the low address area and the PD area which are 
described in Section 2. 



GENERAL ORGANIZATION 
OF VIRTUAL STORAGE 






t 


L 


Supervisor 




BG-R 




F4-R 


Rea 


F3-R 


Address 


F2-R 




1 


F1-R 


< 


Main Page Pool 
(for programs 
executing in 
virtual mode) 


i 


i 


BG-V 

(Minimum always 
64K) 




F4-V 


Virtual 

Address 

Area 


F3-V 




' 


F2-V 




F1-V 


i 


Shared Virtual Area 
(not applicable to a 
single partition system) 



Partitions 

(See note) 
Background 

Foreground 4 

Foreground 3 

Foreground 2 

Foreground 1 



Low address storage 



For details, 

see Section 2-E-2. 



CPU model-dependent logout area 



Background communication region 



System communication region 



Save areas 

Option tables 

I/O tables and information blocks 



F1 Foreground communication 

F2 regions (One for each 

F3 partition specified during 

F4 system generation) 



Logical transient area (LTA) 



Physical transient area (PTA) 



PD area (optional) For details, 

see Section 2-B-3 



CCW translation routines 



Page management routines 



VSAM routines 



Machine check handler, 
Channel check handler. 



RAS transient area (RTA) 



Page management tables, 
CCW translation copy blocks 



Supervisor organization 



Note: Up to five partitions may be specified: one background and four fore- 
ground. Each partition consists of the pair "real partition - virtual 
partition ". 

The SVA and each virtual or real partition must be a multiple of2K. It may also, 
however, be 0K, except the SVA and BG virtual which must be at least 64K. 
To be active a foreground partition must have a virtual partition of at least 64K. 



Figure 4.1 The organization of Virtual Storage. * ... 

The organization of the supervisor area is also illustrated and parts of it are described in 
this Section. 
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COMMUNICATION 
REGIONS 



Partition Communication Regions, (Comregs) 

In a multiprogramming system individual communication regions are defined for 
each partition. The communication region (comreg) belonging to the active 
partition is an area that serves as an initial pointer to other supervisor tables and 
areas. The comreg also contains pointers to user program tables and areas. The 
MVCOM and COMRG macro instructions enable access to information contained in 
these regions. Fields in the comreg are addressed relative to the first byte. The com- 
munication regions are located within the supervisor and their format is described 
in Figure 4.2 and Figure 4.3, parts 1 through 6, explain the contents of each field. 



Locating the partition communication regions 

After IPL, low address storage bytes X'14— 17' contain the address of the comreg 
used by the active partition. 



Note: The contents of these bytes will not be valid after executing the stand-alone 
dump program. Therefore, it is important for the operator to dump, or display 
and note, the contents of low address storage before executing the stand-alone 
dump. Locate bytes X'7C and '7D'in the active comreg. This is the address of 
PLB2, also referred to as the PIB (program Information Block) Extension. The first 
two bytes of an entry in the PIB2 contain the address of its associated comreg. 
(Refer to Chapter 7 in this Section for a detailed description of the PIB2J 

Example A below shows a dump of low address storage. Bytes X'14— 17' contain 
the address 04A0. This address has then been located in a stand-alone dump output 
as shown in example B. The address of PIB2 is indicated in this example. 
Example C shows the PIB2 from which the addresses of all the partition comregs 
are found. 



Example A 



( 0' 



. I rM...Q.QO.Q.GO. ^^ 

• I O00000O0 00000000 00000000 00000000 oooooooo ooo(£m 



of, 



40000000 oooooooo 






AZOB.00.0.0 00.040OC 440C0000 000013AA -..OOOOOOOO OOOOOOOO 470F20O0 (£**<>ht> 



Example B 



07B7E0 


E2C9C4C5 


BLOCK 000^^~ 


000000 


/0900A619 


000020 


47000000 


000040 


O007B038 


000060 


440COOOO 


000080 


00000540 


0O00AO 


] OOOOOOOO 


00OOCO/ 


OOOOOOOO 


00Q4AOT 


F1F261F0 


0004CO 


00060FFF 


0004E0 


41044296 


000500 


46300000 



40E2E3D6 D9C1C7C5 40E4D5C3 

s*vv\*\JO\.\. UUUIUUUU UUUUA3I-U 

OOOOOOOO 00020007 00040005 

OOOOOOOO 20000060 000002CO 
— SAME— 

F661F7F3 70007000 OOOOOOOO 

00043067 OOOOOOOO 00000010 

42974389 3F003F06 3FOC38F1 

30CC3E4C 3EBC0010 OOOOOOOO 



C8C1D5C7 C5C4C3C8 C105C7C5 C4404004 c /— / J J / , A— ' 

a /Ore "00 |00000000| 4B4B4B4B 4B4B4B4B «. i. ■/.../. 

r uvt ooo oooooooo 470F2000 0000090c 

900 01AAAB17 00080000 0000A67E C 

UUUIUOOO 0007B3AA 00080000 0000A67E 

10043010 00010000 OOOOOOOO 000001E0 / . . 

oooooooo oooooioo 60oooooc oooooooo r&gZ&i X 7C — " • 

OOOOOOOO OOOOOOOO 05D640D5 C104C540^-—{ X ~? ..*... NO NAME 

OOOBFFFF FD7FCED3 1000CE50 002E40WJ /U/^U*» oKP/JSO •• •••L... «.. . 

F2F0F6F7 F3F3F4F0 0000 3CD4 022PJ03C »» nOU**^' Y~ r, "<- 673340... M. 

00008090 00007118 00003864 C3BD4J 5A30 H "(£xg/KT) 



Example C 




-*J? 
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FnCOMREG* 

Displacement 
hexadecimal 
Displacement 
decimal 



Displacement 
hexadecimal 
Displacement 
decimal 



Displacement 
hexadecimal 
Displacement 
decimal 



Displacement 
hexadecimal 
Displacement 
decimal 



Displacement 
hexadecimal 
Displacement 
decimal 
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8 
8 


0A 
10 


OC 

12 


17 
23 


18 
24 


20 
32 


24 
36 


28 
40 


?c 

44 


Date 


Address of 
PPBEG 


Address of 
EOSSP 


Problem 
Program Use 


UPSI 
Byte 


Job Name 


Highest 
Storage 
Address 
of the 
Partition 


End Address 
of Last Phase 
Fetched or 
Loaded 


Address of 
Uppermost 
Byte of Phase 
with Highest 
Ending Address 


Label 
Area 
Length 


XXXXXXXXX 


XX 


XX 


XXXXXXXX 


X 


XXXXXXXX 


xxxx 


XXXX 


XXXX 


XX 



2E 


30 


34 


35 


36 


37 


38 


39 


3A 


3B 


3C 


3E 


46 


48 


52 


53 


54 


55 


56 


57 


58 


59 


60 


62 


PIK 


End of 


Machine 


System 


Standard 


Dump 


Job 


Linkage 


Language 


Job 


Disk 


Address 




Virtual 


Confg. 


Confg. 


Language 


Log 


Control 


Control 


Translator 


Duration 


Address of 


of 




Storage 


Byte 


Byte 


Translator 


RELLDR 


Byte 


Byte 


Control 


Indicator 


Label 


FOCL 




Address 






I/O 
Options 


and ASCII 
Options 






Byte 


Byte 


Cylinder 




XX 


XXXX 


X 


X 


X 


X 


X 


X 


X 


X 


XX 


XX 



Job Control Switches 



40 


42 


44 


46 


48 


4A 


4C 


4E 


4F 


58 


5A 


5C 


64 


66 


68 


70 


72 


74 


76 


78 


79 


88 


90 


92 


Address 


Address 


Address 


Address 


Address 


Address 


Address 


Line 




LIOCS 


Address of 


ID Number 


of 


of 


of 


of 


of 


of 


of 


Count 




Comm. 


PIB Table 


of Last 


PUBTAB 


FAVP 


JIBTAB 


TEBTAB 


FICL 


NICL 


LUBTAB 


for 
SYSLST 


System date 


Bytes 




Checkpoint 
or DASDFP 
Indicator 


XX 


XX 


XX 


XX 


XX 


XX 


XX 


X 


XXXXXXXX 


XX 


XX 


XX 



5E 
94 


60 
96 


62 
98 


64 
100 


66 
102 


68 
104 


6A 
106 


6C 
108 


6E 
110 


Job Zone 

in 

Minutes 


Address of 
Disk 

Information 
Block (DIB) 


Reserved 


Address of 
PC Option 
Table less 
8 Bytes 


Address of 
IT Option 
Table 


Address of 
OC Option 
Table less 
8 bytes 


Key of 
Program 
with Timer 
Support 


Reserved 


Logical 

Transient 

Key 


XX 


XX 


XX 


XX 


XX 


XX 


XX 


XX 


XX 



70 


74 


78 


7C 


•7E 


80 


84 


86 


87 


112 


116 


120 


124 


126 


128 


132 


134 


135 


Address 


Address 


Address 


Address of 


Address of 


Address of 


Address of 


Op- 


System 


of 


of JA 


of 


PIB 


MICR DTF 


QTAM 


BG Comm. 


tion 


Configuration, 


SYSPARM 


Partition 


TOD-clock 


Extension 


Table 


Vector 


Region 


Indi- 


Byte 2, and 




Table 


Common 
Area 


(PIB2) 


(PDTABB) 


Table 




cator 


RMSR Open 
Flag Byte 


XXXX 


XXXX 


XXXX 


XX 


XX 


XXXX 


XX 


X 


X 



88 


8C 


8D 


8E 


8F 


97 


98 


9F 


A0 


A4 


136 


140 


141 


142 


143 


151 


152 


159 


160 


164 


Reserved for 


Standard 


Temporary 


Disk 


Catalog 


Switch 


JCL 


81 byte 


Address of 


POWER/VS 


compatibility 


Job Control 


Job Control 


Config- 


Procedure 


for 


Statement 


sysin 


Partition 


Flag 


reasons 


Options 


Options 


uration 


Name 


Catalog 
Procedure 


Name 


indica- 
tor 


Control 
Block 


Bytes 


XXXX 


X 


X 


X 


XXXXXXXX 


X 


xxxxxxx 


X 


XXXX 


XX 



Figure 4.2 Format and contents of any partition communications 

*The address of the communications region is in fixed location X'14' — X'17' 
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PARTITION COMMUNICATION REGION ( Cont'd) 



Displacement 



(Dec) (Hex) 



8 
10 

12 

23 
24 
32 



36 
40 



44 
46 



48 
52 



00 



08 
OA 

OC 

17 
18 
20 



24 



28 



2C 

2E 



30 
34 



Meaning 



MM/DD/YY or DD/MM/YY either set permanently at IPL time or temporary by the job 

control date statement, or updated every time a GETIME macro is issued when 

time-of-day support is provided. 

Format controlled by BGCOMREG +53. 

(System Configuration Byte, data convention bit 0) 

Address of the problem program area. (PPBEG) 

Address of the beginning of the problem program area. The 16 lower order bits of 
Y (EOSSP) equals Y (PPBEG) 

User area. If seek separation option is specified, bytes 12 and 13 are used at IPLtime 
for the address of the seek address block. 

Use program switch indicator. (UPSI byte) 

Job name set by the job control program from information found in the job statement. 

Address of the uppermost byte available to the problem program, that is either the 
address of the uppermost byte of the partition as determined during processing of the 
ALLOC or ALLOCR macro or statement, or the end address of the area specified by 
the SIZE parameter in the EXEC statement. 

Address of the uppermost byte of the last phase of the problem program fetched or 
loaded. Not filled in when the phase is in the SVA. 

Highest ending main-storage address of the last phase among all the phases having the 
same first four characters as the operand on the EXEC statement. For the phase 
$LNKEDT this field is not filled in. The address value may be incorrect if the program 
loads any of these phases above or below its link-edited origin address. If the EXEC 
statement has no operand, job control places in this location the highest ending 
address of all programs just link-edited. 

Length of the problem program label area. 

The low order byte identifies the partition (see Appendix B), and equals the 
displacement from the start of the PIB to the start of the PIB of the partition 
(without AP). The PI K from BGCOMREG changes during system operation and 
contains the PIK of the active partition (whichever one is active). The PI K in the 
FnCOMREG remains unchanged. 

End address of virtual storage. 

Machine Configuration Byte (Values set at supervisor generation time) 

Bit 0: Always set to indicate standard storage protect 
1 : 1=Decimal feature (always set) 
2: 1=Floating point feature 

0=No floating point feature 
3: 1=Always set to indicate Physical transient overlap 
4: Always set to indicate standard timer feature 
5: 1=Channel switching device 

0=No channel switching device 
6: 1=Burst made on multiplex channel support 

0=No burst mode on multiplex channel support 
7: Indicates MCH/CCH in system. 
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PARTITION COMMUNICATION REGION ( Cont'd) 



COMMUNICATION 
REGIONS 






Displacement 



(Dec) (Hex) 



53 



54 



55 



56 



35 



36 



37 



38 



Meaning 



(Date convention bit set at generation time by STDJC) 



System Configuration byte 

BitO: 1=DDMMYY 

0=MMDDYY 
1 : 1=Two or more partitions 

0=One partition only supported 
2: 1=DASD file-protect supported 

0=No file-protect support for DASD 
3: 1 = DASDSYSIN-SYSFIL 

0=No DASD SYSIN-SYSFIL 
4: 1 teleprocessing 

0=No teleprocessing 
5: 1=Two or more partitions 

0=One partition only supported 
6: 1=Asynchronous processing 

0=No asynchronous processing 
7: 1=Track Hold 

0=No Track Hold. 

This byte contains the standard language translator I/O options (set by STDJC macro). 



Bit 0: 
1: 



DECK option 
LIST option 



2: LIST X option 

3: SYM option 
4: XREF option 
5: ERRS option 
6: CHARSET option 
7: Reserved. 



1= yes, output object modules on SYSPCH 

1= yes, output source module listings and diagnostics 

on SYSLST 
1 = yes, output hexadecimal object module listings on 

SYSLST (compilers only) 
1= yes, output symbol tables on SYSLST/SYSPCH 
1 = yes, output symbolic cross-reference list on SYSLST 
1= yes, output diagnostics on SYSLST (compilers only) 
1= 48, input on SYSIPT is 48 or 60 character set 



This byte contains the standard supervisor options for abnormal EOJ, Relocating 
Loader and Control statement display and the indicator for the presence of the 
ASCI l-EBCDIC and EBCDIC-ASCI I translation tables. 



1= yes, dump registers and storage on SYSLST 
1=partition in wait state, because volume is to be mounted 
1 = yes, list all control statements on SYSLST 
1=dummy device search in progress; do not enter ERP 



Bit 0: 


Always on 


1: 


DUMP option 


2: 




3: 


LOG option 


4: 




5: 


Not used 


6: 


Relocating Load 




option 


7: 


ASM option 



1= yes. Relocating Loader supported 
1= yes, ASCII supported. 



Job Control byte 



Bit 0: 1= Job accounting Interface (JA) is not supported 
0= Job accounting Interface (JA) is supported 
1 : 1= Return to caller on LIOCS disk open failure 

0= Do not return to caller on LIOCS disk open failure 
2: 1= Job control input from SYSRDR 
0= Job control input from SYSLOG 



Figure 4.3. Key to Communication Region displacement, part 2 of 6 



Debugging for Programmers, part 2. 4.37 



Section 4, Chapter 2 



COMMUNICATION 
REGIONS 



PARTITION COMMUNICATION REGION 



Cont'd) 



Displacement 



(Dec) (Hex) 



56 



57 



58 



59 



38 



39 



3A 



3B 



Job Control byte (. . . . Cont'd) 

Bit 3: 1= Job control output on SYSLOG 

0= Job control output not on SYSLOG 
4: 1= Cancel job 

0= Do not cancel job 
5: 1= Pause at end-of-job step 

0= No pause at end-of-job step 
6: 1= SYSLOG is not a console printer-keyboard or DOC 

0= SYSLOG is a console printer-keyboard or DOC 
7: 1= SYSLOG is assigned to the same device as SYSLST 
0= SYSLOG is not assigned to the same device as SYSLST. 

Linkage control byte 

Bit 0: 1= SYSLNK open for output 

0= SYSLNK not open for output 
1 : 1= Update of Second Level Directory and RAS loadlist in progress. 

(Interface between $MAINDIR and supervisor). 
2: 1= Allow EXEC 

0= Suppress EXEC 
3: 1 = Catalog linkage editor output 

0= Do not catalog linkage editor output 
4: 1= Supervisor has been updated 

0= Supervisor has not been updated 
5: Reserved 
6: 1 = Update of system CI L in progress. 

(Interface between $MAINDIR and supervisor). 
7: 1= Check automatic condense limits and EOJ. 

(Interface between librarian and job control). . 

Language processor control byte. This is a set of switches used to specify non-standard 
language translator options. The switches within the byte are controlled by job 
control OPTION statements and when set to 1 , override standard options. The 
format of this byte is identical to the standard option byte (displacement 54) with 
one exception: Bit 7 in this byte is used to indicate to LIOCS that the rewind and 
unload option has been specified. 

Job duration indicator byte 

Bit 0: 1= Job in progress 

0= Job not in progress 
1 : 1= Dump on an abnormal end-of-job condition 

0= No dump on abnormal EOJ 
2: 1= Pause at EOJ step 

0= No pause at EOJ 
3: 1= Job control output on SYSLST 

0= Output not on SYSLST 
4: 1 = Job is being run out of sequence with a temporary assignment for SYSRDR 

0= Conditions for 1 -setting not met 
5: 1= PCI L is being condensed 

0= PCI L is not being condensed 
6: 1= //DATE statement processed for current job 

0= No //DATE statement processed for current job 
7: 1 = Batch command just issued 

0= Condition for 1 -setting did not occur. 



/iO 
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PARTITION COMMUNICATION REGION ( Cont'd) 



Displacement 


Meaning 


(Dec) 


(Hex) 


60 


3C 


Binary disk address of the volume label area (label cylinder). 


62 
76 


3E-1 

4C j 


Addresses of FOCL, PUB, FAVP, JIB, TEB, FICL, NICLand LUB 
(See Figure 4.2) 


78 


4E 


Set to the value nn specified in the LINES= nn parameter of the STDJC macro. 


79 


4F 


The format of the system date contained within this field is determined by the IPL 
program from information supplied in the date convention bit (displacement 53). 
Bytes 85-87 contain the day count. 


88 


58 


Bytes reserved for use by LIOCS. Transient dump programs insert a key to indicate 
to the LIOCS end-of-volume routine, SSBCMT07, that it was called by a B-transient. 


90 


5A 


Address of the first part of the program information block (PIB) table. 


92 


5C 


ID number of the last checkpoint. Byte 92 is also the temporary indicator of file 
protected DASD. Bits 0-6 correspond to channels 0-6. A bit ON means DASDFP for 
that channel. Bit 7 indicates 2321 DASDFP support. Byte 93 is used at IPL time 
by PIOCS - Bit 0: 1 = 3330 file protection 
Bit 1 : 1 = 3340 file protection 


94 


5E 


Job zone for Time of Day. If ZONE=EAST, value is positive; if ZONE=WEST, 
value is negative. 


96 


60 


Address of the disk information block (DIB) table for the partition. 


98 


62 


Reserved. 


100 


64 


Address for PC, IT, and OC option tables. 


104 


68 




106 
108 


6A 
6C 


Key of the program that has internal timer support. The key is the same as the 

PI K for the timer supported partition. If multiple partitions all have timer support it 

is initially X'0010' but may be changed to the PIK of another partition by the 

TIMER command. It is copied into all partition communications regions. If no 

partition has interval timer support, these bytes contain X'0000'. 

Reserved. 


110 


6E 


Logical Transient Key (LTK) contains the same value as the PIK (PID) (Displacement 

46) when the logical transient is requested. When the transient area is not in use, 

LTK is equal to zero. The SVC2 routine sets the LTK. (See Appendix B 

for a description of the LTK). 

The SVC1 1 routine resets the LTK, (only significant in BG communication reg.) 


112 


70 


Address of SYSPARM field. 


116 


74 


Address of Job Accounting partition table. 


120 


78 


Address of the Time of Day Clock common area. 


124 


7C 


Address of second part of program information block (PIB) table. 


126 


7E 


Address of PDTABB, table of DTF addresses for MICR support. 


128 


80 


Address of QTAM vector table (IJLQTTAD). 


132 


84 


Address of background communications region. 
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PARTITION COMMUNICATION REGION (. . . Cont'd) 






Displacement 



(Dec) (Hex) 



134 



135 



136 
140 



141 



142 



143 



86 



87 



88 
8C 



8D 



8E 



8F 



Meaning 



Option Indicator byte 

Bit 0: Reserved 

1 : 1 = EU interface active 

0= EU interface inactive 
2: 1= Teleprocessing request 

0= No teleprocessing request 
3: 1 = Supervisor support for tape 

0= Supervisor does not support tape 
4: Reserved 
5: 1= RETAIN support generated 

0= RETAIN support not generated 
6: 1= Linkage to Channel En d Appendage Routine allowed 

0= Linkage to Channel End Appendage Routine not allowed 
7: 1= GETVIS function has been initiated 

0= GETVIS function has not been initiated. 

System Configuration byte 2 and RMSR Open Flag byte 

Bit 0: 1= PCI L supported 

0= PCIL not supported 
1 : TOD supported 
2: 1= PFIX macro supported 

0= PFIX macro not supported 
3: 1= Fetch $$OPEN by SJOBCTLJ 
4: 1= Fetch $$OPEN by SJOBCTLD 
5: 1= Fetch $$OPEN by SJOBCTLJ for WTM 
6: 1= QTAM supported 

0= QTAM not supported 
7: 1= RPS supported 0= RPS not supported 



RMSR OPEN flags 






Pointer to Option table in SYSCOM. Reserved for compatibility reasons. 

Standard Job Control Option byte 
BitO: 1= EDECK Standard Option 
1: 1= ALIGN Standard Option 
2-6: Not used 
7: 1 = ACANCEL standard 

Temporary Job Control Option byte 
Bit 0: 1= EDECK Temporary Option 
1: 1= ALIGN Temporary Option. 
2-5: Not used 
6:1 = SUBLIB = DF 

Temporary Option 
7:1 = ACANCEL 
Temporary Option 

Disk Configuration byte 
Bit 0-4: Not used 

5: 1 = 3340 supported 

= 3340 not supported 
6: 1= 3330 supported 

0= 3330 not supported 
7: Always 1; indicates 2311 and 2314/2319 supported. 

Catalogued Procedure Name. 



c 
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PARTITION COMMUNICATION REGION ( Cont'd) 






Displacement 


Meaning 


(Dec) 


(Hex) 


151 


97 


Interface byte for Catalogued Procedures 

Bit 0: 1= Procedure being executed 
1:1= Overwrite processing 
2: 1= Procedure with data 
3:1= Overwrite request for Job Control 
4: 1= Insert request for Job Control 
5: 1= Procedure end 
6: 1= SYS LOG procedure 
7: 1= Overwrite request for Supervisor. 




152 


98 


JCL statement name for Catalogued Procedure. 




159 


9F 


SYSIN 81 bytes indicator 

Bit 0: 1= Permanent 81 bytes on SYSRDR 
1:1= Permanent 81 bytes on SYSIPT 
2: 1= Temporary 81 bytes on SYSRDR 
3: 1= Temporary 81 bytes on SYSIPT 
4-6: Not used 
7: 1=Allow /& for MAINT CATALS. 




160 


A0 


Address of POWER/VS partition control block (If 
this field contains binary 0) 


none exist for the partition 


164 


A4 


POWER/VS flag byte 1 
Bit 0: 1 = POWER/VS accounting supported 
1 : 1= Partition under control of POWER/VS 
2: 1= POWER/VS partition 
3-7: Not used 




165 


A5 


POWER/VS flag byte 2 
Bit 0-7: Not used 
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System communication Region (SYSCOM) 

This table is located in the supervisor, immediately after the background partition 
communication region. It contains partition-independent pointers and addresses of 
tables used by the system control program (SCP). The contents of SYSCOM is 
listed in Figure 4.4 parts 1 and 2, displacements are given in hexadecimal from the 
first byte of SYSCOM 

Locating SYSCOM 

Bytes X'80 - 83' of low address storage contain the address of SYSCOM. 

Displacement 



Hex 


00 


04 


08 


OA 


oc 


10 


14 


18 


Dec. 


00 


04 


08 


10 


12 


16 


20 


24 




Address 


Address 


Address 


Address 


Address 


Address 


Address 


Address 




of Error 


of 


of 


of 


of 


of 


of I/O 


of External 




Block 


Attention 


Operator 


Operator 


SYSRES 


Fetch 


Interrupt 


Interrupt 






Exit 


Option 
Cancel 
Exit 


Request 

Cancel 

Exit 


PUB 


Routine 


Routine 


Routine 



Hex 


1C 


20 


24 


25 


28 


2A 


2C 


2E 


Dec 


28 


32 


36 


37 


40 


42 


44 


46 




Address 


Address 


Free 


Address 


Number 


Length 


Number 


Not Used 




of 


of First 


List 


of 


of 


of One 


of 






Logical 


Byte of 


Poi 


Channel 


Channel 


Error 


Partitions 






Transient 


Problem 


nte,r 


Queue 


Queue 


Queue 








Area 


Program 
Area 






Entries 


Entry 







Hex 


30 


34 


38 


3C 


40 


44 


46 


48 


Dec 


48 


52 


56 


60 


64 


68 


70 


72 




Address 


Address 


Address 


Address 


Flags and 


System 


Address 


Address 




of 


of 


of 


of 


Switched 


Task 


of 


of 




Channel 


CRT 


Seek 


Channel 




Selection 


Task 


PD Area 




Buckets 


Table 


Address 

Block 

Table 


Control 
Table 


expansions) 


Control 
Field 


Selection 





Hex 


4C 


50 


54 


58 


5A 


5C 


60 


Dec 


76 


80 


84 


88 


90 


92 


96 




Address 


Address 


Address 


Key of 


Key of 


Power/VS 


Reserved 




of Track 


of Timer 


of AB 


Task 


Task 


Partition 
if 

Power/VS 
initiated 






Hold 
Table 


Request 
Table 


Table 


Owning 
LTA 


Running 





Hex 


64 


68 


6C 


70 


74 


78 


7C 


80 




Dec 


100 


104 


108 


112 


116 


120 


124 


128 






Address 


Address 


Address 


Address 


Address 


Address 


Address of 


Base 






of 


of 


of 


of 


of 


of PUB 


Job 


Address 






RF 


EUECB 


OLTEP 


RAS 


ASCII 


Owner- 


Account- 


of Page 






Table 


Table 


Bucket 


Linkage 


Translate 


ship 


ing 


Management 












Area 


Table 


Table 


Common 
Table 


Routine 




Hex 


84 


88 


8C 


90 


94 


98 


9C 


A0 


A1 


Dec 


132 


136 


140 


144 


148 


152 


156 


160 


161 




Base 


Address 


Address 


Address 


Address 


Address 


Address 


Align- 


Pointer 




Address 


of 


of Line 


of 


of PTA 


of First 


of Task 


ment 


to 




of Channel 


SDAID 


Mode 


VSAM 




System 


Block 


Byte 


RAS 




Program 


Save 


Table 


Comm 




Task 


of 




Task 




Translation 


Area 




Area 




Block 


active 




Block 




Routine 












System 
Task 
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Hex 
Dec 



A2 


A3 


A4 


A5 


A6 


A7 


BO 


B4 


B8 


162 


163 


164 


165 


166 


167. 


176 


180 


184 


Pointer 


Pointer 


Pointer 


Pointer 


Pointer to 


Reserved 


Not 


Address 


TRTMSK 


to 


to 


to CRT 


to ERP 


PAGEIN 


9 X'OO' 


Used 


of 


pointer 


PMGR 


SUPVR 


Task 


Task 


Task block 






MVCFLD 




Task 


Task 


Block 


Block 












Block 


Block- 
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Hex 


BC 


BE 


CO 


CB 


CC 


CE 


DO 


D4 


D8 


Dec 


188 


190 


192 


203 


204 


206 


208 


212 


216 




Not 


Not 


Reposi- 


Number of 


Length 


Number 


Address 


Address 


Address 




Used 


Used 


tioning 


Error 


of PUB 


of 


of 


of Page 


of Page 








information 


Queue 


Table 


Active 


Segment 


Frame 


Frame 








for 2560/ 


Entries 


in Bytes 


Partitions 


Table 


Table 


Table 








5425 ERP 












Extension 



Hex 
Dec 



DC 


E0 


E4 


E8 


EC 


F0 


F4 


F5 


F8 


FC 


100 


220 


224 


228 


232 


236 


240 


244 


245 


248 


252 


256 




Address 


Reserved 


Address 


Address 


Address of 


SVA 


Address 


Address of 


Address of 


Pointer to 


of 


of DPD 




of 


of End 


Fetch 


Flag 


of SVA 


System 


RPS LDL 


RPS Sector 


Boundary 
Box 


Table 




VIRTAD 
Routine 


of Real 
Storage 
(Fullword) 


table 


(See 
expansion) 




GETVISarea 


in SVA 


Calculation 
Routine 
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Dec 


Hex 


Description 


64 


40 


Reserved for RMS support on the Models 115 and 125 






X'80' 


RMSR for channel attached devices, tapes and TP devices 






X'40' 


Full RMS support (MCAR/CCH and RMSR) 






X'20' 


MCAR/CCH support 


65 


41 


X'80' 


Initial selection of ErP 






X'40' 


Reserved 






X'20' 


Timer interrupt pending 






X'10' 


MICR Stacker-select active 






X'08' 


Invalid address during fetch 






X'04' 


SIO routine entered after interrupt 






X'02' 


Reserved 






x'or 


IPL in progress 


66 


42 


X'80' 


Initial RAS request 






X'40' 


RAS WAIT request outstanding 






X'20' 


RAS IPL in progress 






X'10' 


Reserved 






X'08' 


POWER/VS supported 






X'04' 


POWER/VS initialized 






X'02' 


GETREAL for SDAID in progress 






x'or 


Fetch for system task in progress (used by PDAID's) 


67 


43 


Reserved 





LAYOUT OF SYSTEM TASK SELECTION CONTROL FIELD 


244 F4 


SVA Flag 




X'80' Do not test for warm start copy of SVA 




X'40' SDL active 




X'20' No 'Set SVA' or 'Set SDL. allowed 




X'10' Build of SDL in progress 




X'08' SDL overflow 




X'04'| 




X'02' > Reserved 




x'or; 



Dec 


Hex 


Description 


68 


44 


Always zero 


69 


45 


SELECT byte: 

X'00' No system task active 

X'01' RAS active 

X'02' PMGR active 

X'03' SUPVR active 

X'04' CRT active 

X'05' ERP active 

X'06' PAGEIN active 



Figure 4.5 
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For your notes 



^ 



\^S 
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LUB entry 
number for 
first BG 
System Logical 
Unit 



System and 
Programmer 
Logical Units 

| ► SYSRDR 

SYSIPT 

SYSPCH 

SYSLST 

SYSLOG 

SYSLNK 

SYSRES 

SYSSLB 

SYSRLB 

SYSUSE 

SYSREC 

SYSCLB 

SYSVIS 

SYSCAT 

> SYSOOO 

SYS001 

SYS002 



FICL 



r 



LUB | 
entry | 
number i 

00 

01 

02 

03 

04 

05 

06 

07 

08 

09 

OA 

OB 

OC 

OD 

OE 

OF 

00 



PUB pointer 



I 



SYSmax 



■D 

0) 


00 


_J 


I 
J 


SYSRDR 


a> r- 
*- OC 


OE 


SYSIPT 


S < 


3A 


SYSPCH 


.Q Z 






o 


by 


~1 


i 

i 
i 


SYSCAT 


CD "D 

-9 c 




SYSVIS 


3 Q 

Z T3 




SYSOOO 






SYS 


001 


LUB entry 










number for 






' 


' 


first program 


mer 




SYSmax 


unit for 


F1 











SYSCAT 
SYSVIS 
■> SYSOOO 
SYS001 



I 



SYSmax 



SYSRDR 



00 FF 

00 FF 

01 FF 

02 00 



FFFF 



£ 

o >_ 



E cn 

CD LL 



E _ 

E ° 

CO M 

CT1 CO 

2 3 



E _ 

CO u. 



E 
E 

CO r- 



I— " 



r 



._i 



y 



NICL 

Number of bytes required 
depends on NPARTS 
Number of programmer 
LUBs in appropriate partition 



OE 


1E 


OF 


OF 







BG BG F2 F1 



-J I 



I 



FAVP 



r 



___§} 



JIB 

entry 

number 



Temp assignment 
//ASSGN SYSLST, X'13V 

JIBTAB 



.J 



r->00 

►01 

02 

03 

04 

OC 
OD 
OE 
OF 
10 
11 



030E00FF 



JIB 

(See Figure 4.12. 



PUB 
I entry 
| number 
. t w . oo 

01 
02 
03 
04 



i 



1__. 



OC 
OD 

*-0E 

OF 
10 
11 



▼ 
1B 



1C 



►22 
23 



Device | CHANQ pointer- 

address i 



000C (00 



PUB (See Figure 4.8.) 

PUB entries for 
channel 



0131 



PUB entries for 
channel 1 




PUB entries for 
channel 2 



PUB entries for 
channel 3 



PUB entries for 
channels 4, 5, and 6, 
if supported 



00 OE 1C 22 FF FF FF 



FOCL 



X FF indicates 
that the channel 
is not supported 



Chan 
Chan 1 
Chan 2 
Chan 3 
Chan 4 
Chan 5 
Chan 6 



FLPTR 



02 




CC 8 pointer 



"I 



I 



Channel 

Control 

Table 

(See Figure 4.14.) 



/ If program is virtual, this 
^J pointer points to the 
— S copied CCB, which in 

I turn points to the copied 

K CCW block (s). 



Chan 




Chan 1 




Chan 2 




Chan 3 




Chan 4 




Chan 5 




Chan 6 





CCB Copy Block 



CCW Copy Block(s) 



IDAL Block 



(Refer to Chapter 13 
in this Section for a 
description of Channel 
Program Translation.) 



~l 



u. 



Channel Buckets (See Figure 4.1 5.) 

One 24 byte entry for each channel; 

no entry is made for channels not supported. 



Error Recovery Block (See Figure 4.16.) 



Up to 25 entries max. each entry being 44 bytes 



L 



Input/output control system in user problem progran 



CCB (Refer to Chapter 5 in this Section.) 



Channel Program (Refer to Chapter 5 in thi 



CCB (Refer to Chapter 5 in this Section.) 



Channel Program (Refer to Chapter 5 in thi 



Explanation of the figure. 

7776 contents of the tables indicate the following: 

The system has 3 partitions. 

» Logical unit SYSRDR is assigned to device address OOC. 

SYSCLB is unassigned. 

SYSLST has a temporary assignment to device address 1. 

Device OOC is queued and chained, indicating two I/O 

requests for this unit. 
The CCB pointer for the first I/O request points to a 

LIOCS DTP in the user program that is running in real rr, 
The CCB pointer for the second I/O request points to a 

PIOCS CCB and channel program in a user program 

running in virtual mode. 

I/O channels 4, 5, and 6 are not supported by the systerr 

Figure 4.6. The interrelationship between the Supe 
and information blocks, and the user program IOC J 
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PUB pointer 



NICL 

Number of bytes required 
depends on NPARTS 
Number of programmer 
LUBs in appropriate partition 



OE 

- H 


1E 


OF 


OF 







BG BG F2 F1 



I 



•I" 



r 



i 

i 



FAVP 



r 



____§D 



._l 



JIB 

entry 

number 



Temp assignmen t 
//ASSGN SYSLST, X'131' 

JIBTAB 



.J 



r-^oo 

►01 

02 

03 
04 

oc 

0D 
OE 
OF 
10 
11 



030EOOFF 



JIB 

(See Figure 4.12. 



PUB 
I entry 
I number 
. t .». 00 

01 
02 
03 
04 



I 



_!__ 



0C 
OD 

fc-OE 

OF 
10 
11 



1C 



21 
►22 
23 



00 OE 1C 22 FF FF FF 



Device \ 

address i 



000C 100 



PUB (See Figure 4.8.) 

PUB entries for 
channel 



0131 



PUB entries for 
channel 1 




PUB entries for 
channel 2 



PUB entries for 
channel 3 



PUB entries for 
channels 4, 5, and 6, 
if supported 



FOCL 



X FF indicates 
that the channel 
is not supported 



Chan 
Chan 1 
Chan 2 
Chan 3 
Chan 4 
Chan 5 
Chan 6 
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■CHANQ pointer 



CHANQ 
I entry 

I number 

1 >00 



l~" 



CC8 pointer 



1 



r 



FLPTR 

_J 



02 



01 
02 
03 
04 

i 

OC 
OD 
OE 
OF 
10 
11 






X- — 






CHANQ (See Figure 4.13.) 



1 



L 



Channel 

Control 

Table 

(See Figure 4.14.) 



If program is virtual, this 
X J pointer points to the 

S copied CCB, which in 

I turn points to the copied 
K CCW block (s). 



Chan 




Chan 1 




Chan 2 




Chan 3 




Chan 4 




Chan 5 




Chan 6 





L. 



CCB Copy Block 



CCW Copy Block(s) 



IDAL Block 



(Refer to Chapter 13 
in this Section for a 
description of Channel 
Program Translation.) 



1 



Channel Buckets (See Figure 4.15.) 

One 24 byte entry for each channel; 

no entry is made for channels not supported. 



Error Recovery Block (See Figure 4.16.) 



Up to 25 entries max. each entry being 44 bytes 



I 



I 



Input/output control system in user problem program area. 



CCB (Refer to Chapter 5 in this Section.) 



Channel Program (Refer to Chapter 5 in this Section.) 



A 



Logical IOCS 
)> (Refer to Chapter 4 
in this Section.) 



CCB (Refer to Chapter 5 in this Section.) 



Channel Program (Refer to Chapter 5 in this Section. 



> 



Physical IOCS 
(Refer to Chapter 4 
in this Section.) 



Explanation of the figure. 

The contents of the tables indicate the following: 

• The system has 3 partitions. 

Logical unit SYSRDR is assigned to device address OOC. 

S YSCL B is unassigned. 

SYSLST has a temporary assignment to device address 131. 

Device OOC is queued and chained, indicating two I/O 

requests for this unit. 
The CCB pointer for the first I/O request points to a 

LIOCS DTF in the user program that is running in real mode. 
The CCB pointer for the second I/O request points to a 

PIOCS CCB and channel program in a user program 

running in virtual mode. 

I/O channels 4, 5, and 6 are not supported by the system. 



Figure 4.6. The interrelationship between the Supervisor I/O tables 
and information blocks, and the user program IOCS. 



Note: All numbers shown are in 

hexadecimal and are 

inserted for illustration purposes only. 
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The LUB table 

This table is built up during system generation by the IOTAB supervisor generation 
macro, according to the BGPGR and FnPGR parameters (where n is the partition 
number). The table has one entry for each logical unit required for the system. 
Each entry is two bytes long and entries are grouped into two classes: 

• System LUBs 

• Programmer LUBs 

There are always 14 system LUBs for each partition on the system. 

By examining the contents of this table you can see the logical units that: 

• Are unassigned or assigned (and, if assigned, to which entry in the PUB table) 

• Have a temporary assignment or an alternate assignment, or indicate that a 
DASD file is opened. 

How to locate: 

Bytes X'4C— X'4D' in the partition communication regions contain the address 
of the first entry in this table. Label LUBTAB in the supervisor listing identifies 
the address of the first byte of this table. 

The number of LUB entries for system logical units in the BG System LUB and the 
number of LUB entries for programmer logical units in each programmer LUB is 
stored in the NICL information block. 

NICL, (Number in Class List) 

Byte of this information block contains the number of System LUB entries (for 
DOS/VS, always 14, X'OE'). Byte 1 contains the number of programmer LUBs for 
the BG partition, and the remaining bytes contain the number of programmer LUBs 
for each foreground partition in the system (one byte per partition). 
The total number of bytes in the NICL is equal to the number of partitions in the 
system plus one. 

How to locate 

Bytes X'4A' — X'4B' of the partition comregs contain the address of the first entry 

in this information block. Label NICL in the supervisor listing identifies the 

address of the first byte of this information block. 

A pointer to the first entry in the LUB table and a pointer to the first LUB entry 

for the programmer LUBs for each partition is stored in the FICL information 

block. 

FICL, (First In Class List) 

Each byte of this information block points as a displacement index to the 
beginning of a LUB sector. 

Byte to the first LUB entry, and the remaining bytes to the first LUB entries for 
each programmer LUB of each partition. The total number of bytes in the FICL is 
equal to the number of partitions in the system plus one. 

How to locate: 

Bytes X'48' — X'49' of the partition comregs contain the address of the first entry 
in this information block. Label FICL in the supervisor listing identifies the 
address of the first byte of this information block. 

Figure 4.7 (opposite) shows the format and contents of the LUB table, and expands 
one entry in order to explain its contents. The figure also shows the relationship 
between the LUB, NICL, and FICL. 
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O 






Number in 
Class List 
(NICL) 



SYS 



BG 
F4 



F3 
F2 
F1 



LUBTAB 



First in 
Class List 
(FICL) 



BG 

System LUBs 



BG 

Programmer LUBs 



F4 

System LUBs 



F4 

Programmer LUBs 



F3 

System LUBs 



F3 

Programmer LUBs 



F2 

System LUBs 



F2 

Programmer LUBs 



F1 

System LUBs 



F1 

Programmer LUBs 



SYS 



BG 



F4 



F3 



I— F2 



r F1 



System Lubs 



LUB Table for any 
Partition 



Programmer Lubs 



SYSRDR 
SYSIPT 
SYSPCH 
SYSLST 
SYS LOG 
SYSLNK 
SYSRES 
SYSSLB 
SYSRLB 
|D SYSUSE 
SYSREC 
SYSCLB 
SYSVIS 
SYSCAT 
SYSOOO 
SYS001 
SYS002 
SYS003 
SYS004 

\l) SYSnnn 



I/O TABLES AND 
INFORMATION BLOCKS 




1 
10 



Points to first PUB and PUBOWNER 
Points to second PUB and PUBOWNER 
Points to third PUB and PUBOWNER 



11111110— Ignore, assigned ignore 
11111111 - Null Pointer, the LUB is unassigned 
When a logical unit is assigned, the system inserts a pointer 
to the PUB for the physical device specified. 
























































































ByteO 


Byte 1 


PUB Pointer 


JIB Pointer 



1 ) SYSUSE may be called SYSCTL in error recovery messages. 

2) Since there are 14 system LUBs for each partition, 

the maximum number of Programmer LUBs is as follows: 

When number of partitions (NPARTS) = 1:241 

When number of partitions (NPARTS) = 2:227 

When number of partitions (NPARTS) = 3:213 

When number of partitions (NPARTS) =4:199 

When number of partitions (NPARTS) =5:185 



JIB Index (Multiply by 4 = Displacement into JIB Table) or 
X'FF' = Null Pointer, no JIB for this LUB. 

A LUB has a JIB pointer in three situations: 

1 . The logical unit is temporarily assigned. 

2. The logical unit assignment is alternate (ALT). 

3. A DASD file (except a system I/O file on disk) is 
opened (DASD file protect only). 



o 



Figure 4.7. The LUB table. 

The figure illustrates the format and contents of one entry and shows its relationship to the 
NICL and FICL information blocks. 
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The PUB table 

This table is built up during system generation by the IOTAB supervisor genera- 
tion macro and each DVCGEN macro fills one PUB entry in the PUB table. 



By examining the contents of this table you can see both the physical address of 
each I/O device attached to the system and which devices are queued in the 
CHANQ. In conjunction with the contents of the LUB and JIB, you can ascertain 
the status of an I/O request for any logical unit. 

The number of bytes in the PUB table (its size) is determined during system 
generation, although the operator can ADD or DELETE I/O devices during IPL. 
The PUB is divided into seven parts, each part containing the I/O devices attached 
to one of the seven channels. The first entry in the PUB belongs to the I/O device 
with the highest priority on channel 0. A pointer to the first PUB entry for each 
channel on the system is stored in the FOCL information block. 

How to locate: 

Bytes X'40' — X'41' of the partition communication regions contain the address 
of the first entry in this table. Label PUBTAB in the supervisor listing identifies 
the address of the first byte of this table. 

The figure below shows the format and describes the contents of an entry in the 
PUB. Figure 4.9 (opposite) details a PUB entry to bit level. 



PUBTAB 



Channel 
PUBs 



Channel 1 
PUBs 



Channel 6 
PUBs 



FF 



PUB-table 
delimiter 



PUBEND 



Job Control Flags 
Channel Scheduler Flags 

Device Type 

TEB Pointer 
Retry Counter 
Unit 



n 



y 



-Channel Queue Pointer 
- Channel 

Device Characteristic Code 
or SAB Pointer 



Figure 4.8. Format and contents of an entry in the PUB 



FOCL (First on Channel List) 

Byte of this information block points as a displacement index to the first PUB 
entry for the I/O device attached to channel 0, and byte 1 points to the first 
PUB entry for channel 1. The remaining five bytes point to the first entries in 
the PUB belonging to channels 2 to 6. X'FF' indicates that the associated channel is 
not supported on the system. 



How to Locate: 

Bytes X'3E' - X'3F' of the partition communication regions contain the address 
of the first entry in this information block. Label FOCL in the supervisor listing 
identifies the address of the first byte of this information block. 
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Byte 0: Channel number. (Hex 0-6, FF = NULL) 

Byte 1 : I/O device unit number 

Byte 2: Hex 0, 1, 2, points to the first channel queue entry for this device. 

Byte 3: If device is a 2495 Tape Cartridge Reader and TEBs are specified, this 

byte is a TEB pointer (Hex 1 , 2, 3, ). Otherwise, this byte is a ERP retry counter. 

Byte 4: Device type code. See Figure 4.10, parts 1 through 3. 

Byte 5: SS of the MODE= parameter in the DVCGEN macro for tape unit (See Section 2). 
For the Models 115 and 125 ICA line, this byte contains the displacement index of 
the entry in the Line Mode Table (LMT). The address of the LMT is contained 
in bytes X'8C - X'8F' of SYSCOM. 

For DASD with seek separation, this byte is used as the SAB Pointer. 
With Track Hold but not seek separation supported, this byte contains 
a pointer to the Track Hold Table entry or X'FF' (with both SKSEP and 
TRKHLD specified, the track hold pointer is found in the SAB entry). 

For MICR type devices/this byte indicates which external interrupt line 
is in use. 

For a 3705 Communications Controller, this byte contains the type number 
of the Channel Adapter. 

For 2560 or 5425 

Bit 0: 1= Repositioning required 

1 : 0= SYSPCH temporarily assigned to hopper 1 

1= SYSPCH temporarily assigned to hopper 2 
2: 0= SYSIPT temporarily assigned to hopper 1 

1= SYSIPT temporarily assigned to hopper 2 
3: 0= SYSRDR temporarily assigned to hopper 1 

1= SYSRDR temporarily assigned to hopper 2 
5: 0= SYSPCH permanently assigned to hopper 1 

1= SYSPCH permanently assigned to hopper 2 
6: 0= SYSIPT permanently assigned to hopper 1 

1= SYSIPT permanently assigned to hopper 2 
7: 0= SYSRDR permanently assigned to hopper 1 

1= SYSRDR permanently assigned to hopper 2. 

Byte 6: Channel Scheduler Flags 

Bit 0: 1= Device busy 

1 : 1 = Switchable device 

2: 1= EOJ for SYSRDR or SYSIPT 

3: 1= I/O error queued for recovery 

4: 1= Operator intervention required 

5: 1= Device End posting required 

6: 1= Burst mode or overrunnable device on byte MPX channel 

7: 1= 7-track tape unit. 

Byte 7: Job Control Flags 

Bit 0-4: Standard MODE assignment for 7-track tape (all ones 
if not tape, all zeros if device is down) 

Bit 5: 1 = DASD device with Rotational Position Sensing (RPS) feature 

Bit 6-7: B'11' (both on)= Headqueue in progress 
B'01 ' = Headqueue requested. 



f%. 



Figure 4.9. 



Note: A null is generated for each device to be supported by the supervisor. Standard physical 
unit assignments are made to the PUB table at supervisor generation time. 
PUBs are ordered by channel and priority within a channel. 

An entry in the PUB Ownership Table is associated with each entry in the PUB Table, 
if the supervisor has been generated to support multiprogramming. 

Explanation of the contents of an entry in the PUB table 



Debugging for Programmers, part 2. 4.49 



Section 4, Chapter 3 

I/O TABLES AND 
INFORMATION BLOCKS 






Card 
Code 


Actual IBM Device 


Device- 
Type X'nn' 


Device Type 


2400T9 


9-track Magnetic Tape 
Tape units 


50 




2400T7 


7-track Magnetic 
Tape units 


50 




341 0T9 


9-track 3410 Magnetic 


53 






Tape units 




Magnetic Tape devices 


3410T7 


7-track 3410 Magnetic 
Tape units 


53 




3420T9 


9-track 3420 Magnetic 
Tape units 


52 




3420T7 


7-track 3420 Magnetic 
Tape units 


52 




2495TC 


2495 Tape Cartridge 
Reader 


51 


Tape Cartridge Reader 


1442N1 


1442N1 Card Read Punch 


30 




2520B1 


2520B1 Card Read Punch 


31 




2560 


2560 Multifunction Card 


33 






machine 




Card Read Punches 


2596 


2596 Card Read Punch 


30 




3525RP 


3525 Card Punch (with 
optional read feature) 


32 




5425 


5425 Multifunction Card 
Unit 


34 




2501 


2501 Card Reader 


10 




2540R 


2540 Card Reader 


11 




3504 


3504 Card Reader 


12 


Card Readers 


3505 


3505 Card Reader 


12 




1540P 


2540 Card Punch 


21 




2520B2 


2520 B2 Card Punch 


20 




1442N2 


1442N2 Card Punch 


22 


Card Punches 


2520 B3 


2520B3Card Punch 


20 




3525P 


3525 Card Punch 


23 




1403 


1403 Printer 


40 




1403U 


1403 Printer with UCS 
feature 


42 




1443 


1443 Printer 


41 




2260(local) 


1053 Printer with 2848 
Control Unit. MODE 
operand must be entered 
as X'01 ' 


CO 




3203 


3203 Printer 


4A 




3211 


3211 Printer 


43 


Printers 


3277 


3284 or 3286 Printer with 


BO 




(local 3270) 


3272 Control Unit. MODE 
operand must be entered 
as X'01 * 






3277B 


3284 or 3286 Printer with 


BO 




(local 3270) 


3272 Control Unit, attached 
in burst mode to a multi- 
plexer channel. MODE 
operand must be entered 
as X'01 ' 






5203 


5203 Printer 


4C 




52030 


5203 Printer with 
UCS feature 


4D 





"\_ 



v_y 
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Card 
Code 


Actual IBM Device 


Device - 
Type X'nn' 


Device Type 


1050A 


3210, 321 5 Console 
Printer Keyboards 


00 


Printer-Keyboards 


125D 
125DP 


Models 115 and 125 Integrated 

Video Display Unit 

Models 115and 125 Integrated 

Video Display Unit 

with 5213 Console Printer 

attached 


B2 
B2 


Video Display Unit 


UNSP 
UNSPB 


Unsupported device 
Unsupported device 


FF 

FF 


Unsupported. No burst mode 
on multiplexer channel 
Unsupported with burst 
mode on multiplexer 
channel 


2311 
2314 

2314 
2321 
3330 

3340 

3340 

3340 


231 1 Disk Storage device 

2314 Direct Access 

Storage Facility 

2319 Disk Storage Facility 

2321 Data Cell Drive 

3330-1 , 3330-2, or 333-1 

Disk Storage 

3340 Disk Storage 

(general) 

3340 Disk Storage 

with 3348 Mod 35 

3340 Disk Storage 

with 3348 Mod 70 


60 
62 

62 
61 
63 

68 

69 
6A 


DASD 


1419 

1419 

1419 

1419P 

1419S 


1255 Magnetic Character 

Reader 

1259 Magnetic Character 

Reader 

1419 Magnetic Character 

Reader 

1419 Dual Address Adapter 

Primary Control Unit 

1419 Dual Address Adapter 

Secondary Contr. Unit 


72 
72 
72 
73 
74 


MICR- Magnetic Ink 
Character Recognition 
devices 


2701 

A 
2702 I 

D 
2703 

2703 
2703 


2701/2715 Data Adapter 
Unit 

2702 Transmission Control 
Unit 

2703 Transmission Control 
Unit 

Integrated Communications 
Adapter (Models 125 and 135) 
3705 Communications 
Controller in Emulation 
Mode 


DO 
D1 

D2 

D2 
D2 


Teleprocessing lines 

A= SADO comm'd 

r, ^« r^- , . when 

B= SAD1 comm'd 

,•> o« .-»„ , . enab ing 

C= SAD2 comm d , . 

D= SAD3 comm d 


2955 


2955 Data Adapter Unit 


D7 


Data Link for RETAIN 


1017 
2671 


1017 Paper Tape Reader 
with 2826 Control Unit 
2671 Paper Tape Reader 


78 
70 


Paper Tape Readers 
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Card 
Code 


Actual IBM Device 


Device- 
Type X'nn' 


Device Type 


1018 


1018 Paper Tape Punch 
with 2826 Control Unit 


79 


Paper Tape Punch 


1419 

1419P 

1419S 


1270 Optical Reader/ 

Sorter 

1275 Optical Reader/ 

Sorter Primary Control Unit 

1275 Optical Reader/Sorter 

Secundary Control Unit 


72 
73 
73 


Optical Readers 


1287 
1288 
3881 
3886 

3540 


1 287 Optical Reader 

1 288 Optical Page Reader 
*3881 Optical Mark Reader 

3886 Optical Character 

Reader 

3540 Diskette I/O unit 


77 
77 
11 
7C 


Optical Readers 
DISKETTE 


2260 
3277 
(local 3270) 

3277 B 
(local 3270) 


2260 Display Station 
3277 Display Station; 
MODE operand need not 
be entered 

3277 Display Station; 
attached in burst mode to 
a multiplexer channel. 
MODE operand need not 
be entered 


CO 
B0 

BO 


Display Stations 


7770 


7770 Audio Response Unit 


D3 


Audio Response unit 



V 



*Note: The logical unit name SYSIN cannot be assigned to a 3881 
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PUBOWNER (PUB ownership) 

An area in the supervisor is always reserved for this table. The number of entires 
is equal to the number of entries in the PUB, and each entry is two bytes long. 



I/O TABLES AND 
INFORMATION BLOCKS 






^L,^r 



By examining the contents of this table in conjunction with the associated entry in 
the PUB, you can identify the partition using a particular I/O device, for example, 
when conflicting assignments are thought to be the cause of a system malfunction. 



How to locate: 

Bytes X'78' - X'7B' of SYSCOM contain the address of the first entry in this 
table. Label PUBOWNER in the supervisor listing identifies the address of the 
first byte of this table. The Figure below shows the format and describes the 
contents of an entry in the PUBOWNER. 



PUBOWNER 






1 



Byte 0: Bit Reserved 

1 1 = waiting for volume to be mounted 
2-7 Reserved 
Byte 1 : Identifies the partition that owns the PUB according to following table: 



Flag 


Partition owning PUB if number of partition is: 




2 


3 


4 


5 


X'OV 
X'02' 
X'04' 
X'08' 
X'10' 


BG 
F1 


BG 
F2 
F1 


BG 
F3 
F2 
F1 


BG 
F4 
F3 
F2 
F1 



Notes: The number of entries in the PUB Ownership table is equal to the 

number of entries in the PUB table. Associated with each PUB entry 
is an entry in the PUB Ownership table. 



Figure 4. 1 1 Contents of an entry in the PUBOWNER. 

The relationship between the PUB, the PUBOWNER, and the FOCL is shown in Figure 4.6 
at the beginning of this Chapter. 
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The JIB (Job Information Block) 

An area in the supervisor is reserved for this information block during system 
generation by the JIB parameter of the IOTAB macro. This information block 
records any changes to the standard or permanent assignments made by the 
// ASSGN job control statement. Extent information is also recorded in the JIB 
when the supervisor supports the DASDFP feature. 

By examining the contents of an entry in the JIB and its associated LUB, PUB, 
and PUBOWNER entries you can identify the logical units that are temporarily 
assigned, the address of the I/O device, and the partition using the device. Useful 
information can also be obtained from the JIB about DASD extents (DASDFP only), 
for example, when it is not certain why the message INVALID SEEK ADDRESS 
is printed during the execution of a particular job. 



How to locate: 

Bytes X'44' — X'45' of the partition communication regions contain the address of 
the first entry in this information block. Label JIBTAB in the supervisor listing 
identifies the address of the first byte of this information block. 

Entries in the JIB are made: 

• when a temporary assignment is made 

• by alternate tape assignments 

• by DASD extent information (when the file protect feature is supported 
by the supervisor.) 

The next available JIB entry is recorded in the FAVP. 



FAVP (First Available Pointer) 

This is a one-byte pointer to the next available JIB entry. It contains a hexadecimal 
displacement from the first entry in the JIB. If it contains X'FF', no more entries 
in the JIB are available. 

How to locate: 

Bytes X'42' — X'43' of the partition communication regions contain the address 
of this pointer. Label FAVP in the supervisor listing identifies the address of this 
one-byte pointer. 

Figure 4.12 (opposite) illustrates the format and contents of a JIB entry. Its 
relationship to the LUB and PUB is indicated in Figure 4.6. 



o 



c 
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JIBTAB 
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^hj^jr 






1 


2 


3 



y 



\ 



\ 



\ 



Number of entries (length of JIB table) 
is determined at supervisor generation 
time 



o 



Note 1: Only when file-protect on DASD. 

Note 2: Two JIB's are required for a 232 1/3330/3340 extent; one for lower 

limit and one for upper limit. The lower limit defining JIB must 

be chained to the upper limit defining JIB. 

For 2321, byte 1 of this JIB contains the subcell number times 

10 plus the strip number in binary. 



Byte(s) 


Description 


0-1 (Contents 
depends on the bit 
setting in byte 2) 


Bit setting 
Byte 2 


Contents 


Bit 0= 1 


LUB entry of stored standard assignment. 




Stored standarc 


(PUB and JIB pointer) 




assignment 




Bit 1= 1 


ByteO: PUB pointer 




Alternate 


Byte 1 : X'00' 




assignment 




Bit 2= 1 


Byte 0: Cylinder lower limit 




2311/2314/ 


Byte 1 : Cylinder upper limit 




2319 Extent 


See Note 1 


Bit 3= 1 


For 2321 : 




2321/3330/3340 


Lower limit (Cell or combined 




Extent 


subcell and strip), or 

Upper limit (Cell or combined 
subcell and strip) 

For 3330/ Cylinder lower limit, or 

3340: Cylinder upper limit (One cylinder 
number of the 3330/3340 
uses two bytes) 

See Notes 1 and 2 


2 


Meaning if bit = 1 : 




Bit 0: Stored standard assignment 




Bit 1 : Alternate assignment 




Bit 2: 231 1/2314/2319 extent 




Bit 3: 2321/3330/3340 extent 




Bit 4: The alternate assignment indicated in bit 1 is permanent. 




This bit is also on when one of the extent indicators 




(bit 2 and bit 3) is on. 




Bit 5: Catalogued procedures processing 




Bit 6/7: Reserved. 


3 


Chain byte 




Contains the displacement index of the next JIB. 




X'FF' defines the end of the chain. 



o 



Figure 4.1 2 Explanation of the contents of an entry in the JIB. 



Debugging for Programmers, part 2. 4.55 



Section 4, Chapter 3 

I/O TABLES AND 
INFORMATION BLOCKS 



CHANQ (Channel Queue) 

The area in the supervisor reserved for this table is determined during system 
generation by the CHANQ parameter of the IOTAB macro. 

This table is used by the supervisor to schedule I/O operations. An entry is made 
in the channel queue whenever a request is made for an I/O operation, and the 
entry remains in the queue until the operation is completed. Thus, at any point 
in time, the queue will consist of entries for I/O operations in progress and I/O 
operations waiting for initiation. Whenever an I/O event completes, the queue is 
examined to see if an operation is waiting for the device, and if so, ..the operation 
is initiated. 

Each entry made in this table occupies an eight-byte field. Entries are pointed to 
by a CHANQ POINTER contained in byte 2 of any PUB entry owning a device 
waiting for an I/O operation to complete. 

By examining the contents of this table together with the contents of the PUB 
table you can determine the following: 



M IK 



Whether a particular I/O device is waiting for an I/O operation to be completed. 
The reason for an uncompleted operation. 

How many I/O requests have been made for a particular device (by looking at 
the CHAIN byte). 

The CCB (Command Control Block) address and, therefore, the channel 
program and I/O area used by a particular device. (The CCB and channel 
program are described in Chapter 5 in this Section.) 
The identity of the task that requests an I/O operation for a particular 
device. 

Whether the channel queue is completely occupied (probably causing a soft 
wait state). 



How to locate: 

Bytes X'25' - X'27' of SYSCOM contain the address of the first entry in this table. 
Label CHANQ in the supervisor listing identifies the address of the first byte of 
this table. 

The number of channel queue entries occupied at any given point in time depends 
on the I/O activity in the system. A one-byte pointer (FLPTR) points to the next 
eight-byte field in this table that is free for use. 



( 



FLPTR (Free List Pointer) 

This one-byte pointer contains the hex displacement from the beginning of the 
channel queue table to the next available CHANQ entry. When the channel queue 
is full, it contains X'FF'. 



How to locate: 

Byte X'24' of SYSCOM contains the address of this information byte. Label 
FLPTR in the supervisor listing identifies the address of the first byte of this 
information byte. 

For a detailed description of the operation of the CHANQ and FLPTR refer to the 
DOS /VS Supervisor Logic manual. 

Figure 4.13 (opposite) shows the format and describes the contents of the CHANQ 
table, and Figure 4.6 illustrates the relationship between the PUB, CHANQ, and 
FLPTR. 



\J 
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CHANQ 



FLPTR 



o 



PUB * 
byte 2 
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Task requestor Identification 
LUB Displacement 

LUB Identification 

Requestor Identification 



n 



Chain byte 
CCB address 



/ 



/ 



\ 



The length of the queue is determined / 

at supervisor generation time / 

</ 



\ 



\ 






Byte 0: 

Bytes 1-3: 
Byte 4: 



Byte 5: 



Byte 6: 



Byte 7: 



\ 



\ 



Contains the displacement within the channel queue of the next entry in the free 
list or in the list for a specific device, or X'FF' when it is the last entry in the free 
list or a device list. 

Contains the CCB address for the specified device. 

Contains a code identifying the task making the I/O request. The one-byte entry 
indicates to which task the CCB belongs, and is in the form X'nk' where: 
n = user storage protection key. (Attention or system task = 0, BG task = 1 , 
FG tasks = 2-5 depending on the number of partitions.) 
k = f or Attention and all user tasks. 
1 for RAS 



2 for PMGR 

3 for SUPVR 

4 for CRT 

5 for ERP 

6 for PAGEIN 



nK = FF for any unused channel queue entries. 



If the I/O request is from a subtask, this byte does not identify the subtask, but 
the partition. See Appendix B for an explanation of the REQID. 

Contains pointer (displacement index) to the entire LUB table identifying the 
logical unit making the I/O request. This is doubled to get the actual displacement 
into the full LUB table. 

Contains X'FF' if the LUB is a programmer class, or the displacement within the 
partition LUB if it is a system class. 
(Not used by a non-MPS Supervisior.) 

Contains the displacement within the PIB table of the PIB of the task requesting 

I/O, or X'FF' when the channel queue entry is in the free list. 

(Not used by a non-MPS Supervisor.) See Appendix B for an explanation of 

theTKREQID. 



*Notes: FLPTR: The free list pointer contains the displacement within the channel 
queue of the first entry in the free list of X'FF' when the channel queue is 
full. Byte X' 24' of the System Communication Region (SYSCOM) contains 
the address of the Free List Pointer. 
Label FLPTR identifies the location of the pointer (1 byte). 

PUB byte 2: The PUB channel queue pointer contains the displacement 
within the channel queue of the first entry for a specific device. 



© 



Figure 4. 1 3. Explanation of the contents of an entry in CHANQ. 
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Channel Control Table. 

This table contains a code identifying the channel types attached to the system. 
There is one entry for each channel attached, and each entry is two bytes long. 

No system generation macro is required to reserve an area in the supervisor for this 
table; information is entered into it by the STORE CHANNEL ID instruction during 
IPL. 



How to locate: 

Bytes X'3C - X'3F' of SYSCOM contain the address of the first entry in this 
table. Label CHNTAB in the supervisor listing identifies the address of the first byte 
of this table. 

Figure 4.14 (opposite) lists the meaning of the code contained in byte of this 
table; byte 1 is always zero. 



Channel bucket 



This information block is always generated in a supervisor. Each channel attached 
to the system owns a 24-byte field in this information block, which records the 
contents of the I/O registers (general registers 1 , 2, 3, and 4) and a pointer to the 
PIB (Program Information Block) for the last I/O started on each channel. 

Its size, or the number of bytes reserved for this information block, is always 
sufficient to allow a 24-byte field for each of the 7 channels, whether attached to 
the system or not. 

By examining the contents of this block, information relating to the last I/O started 
on any attached channel can be obtained. 

Similar information can be obtained by examining the contents of the PUB, CHANQ, 
and FOCL, but the channel bucket formats the information and, in addition, 
contains a pointer to the PIB. Information in the PIB allows more details about 
the task issuing the last START I/O instruction to be obtained. (The PIB is 
described in chapter 8 in this Section.) 



K 



How to locate: 

Bytes X'30' - X'33' of SYSCOM contain the address of the first entry in this 
information block. Label REGSAV in the supervisor listing identifies the address 
of the first byte in this information block. 

Figure 4.15 (opposite) shows the format and contents of an entry made in the 
channel bucket for a system. 



O 



4.58 Debugging for Programmers, part 2. 



Section 4, Chapter 3 






CHNTAB 


Channel 


Channel 1 


Channel 2 


Channel 3 


Channel 4 


Channel 5 


Channel 6 



/ 



/ 



/ 



/ 



/ 



z. 
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1 



\ 



\ 



\ 



\ 



\ 



\ 



\ 



\ 



\ 



-X 



Byte 0: X'10' = Byte Multiplexer Channel 

X'1 1 ' = Byte Multiplexer Channel with burst mode support 
X"I3' = Byte Multiplexer Channel running in burst mode 
X'OO' = Selector Channel 

X'80' = Channel not operational or not present in the system 
X'20' = Block Multiplexer Channel 

Byte 1 : Always zero 



Figure 4.14. Explanation of the contents of the Channel Control Table 



o 



REGSAV 



/ 



i 1 1 1 — r 

ii ill 






I Bytes 




3 4 



7 8 



11 12 



15 16 



19 20 



I 
23 



Address of first 
PUB on Channel 


CCB Pointer 


Device Address 


PUB Pointer 


Channel Queue 
Pointer 


PIB Pointer 



Notes: 1 A channel bucket contains information related to the last I/O started on the channel. 

2 The number of channel buckets in a system equals the number of I/O channels in the system. 

Figure 4.15 Contents of the Channel Bucket 
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Error Recovery Block and Error Queue 

Real storage area is reserved in the supervisor for the error recovery block during 
system generation by the ERRQ parameter of the FOPT macro. 

The block is used by error queue entries that are built up by the supervisor in the 
event of an I/O device error during program operation. 

Data recorded in an error queue entry is used by both the ERP (Error Recovery 
Procedure) and RMSR (Recovery Management Support Recorder) routines. 

Each error queue entry is 44 bytes long (hex 2C), and the number of entries 
determined by the ERRQ parameter can be between 3 and 25 for a supervisor not 
supporting multiprogramming, or between 5 and 25 for a supervisor supporting 
multiprogramming. 

On the occurrence of an I/O device error that can not be corrected by hardware or 
software error recovery, a message is printed on SYSLOG. The message may require 
operator response or action, and contains data recorded in the error queue. An 
example of this type of message is: 

BG 0P47A UNX INTERV SYS003=2A1 

CCSW=021 000B49002000000 CCB=00B440 
SNS=40200004024024 1 00000000000892 B 1 6 1 4020 1 0200 1 A00 1 



If no message can be printed because of the severity of the error, for example, a 
hard wait state, data recorded in the error queue should be analyzed in a dump 
output. 

By examining the contents of the error queue the following information can be 
obtained about any I/O device error recorded in the queue: 

• The status of the I/O device and the last CCW issued. 

• The active entries, if any (X'OT in byte 10). 

• The address of the associated PUB entry, from which the device address 
can be found. 

• The message code. (This code may refer to a DOS/VS message. For example, 
code 08 refers to device error recovery message 0P08A. The reason for the 
error and possible solutions are listed in DOS/VS Messages.) 

• The address of the associated CCB, from which the address of the channel 
program and I/O area used in the operation can be located. 



1 



^ 



How to locate: 

Bytes X'00' - '04' of SYSCOM contain the address of the first byte in this 
information block. Label ERBLOC in the supervisor listing identifies the address 
of the first byte of this information block. 

Figure 4. 1 6 (opposite) illustrates the format and describes the contents of an error 
queue entry. 
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ERRQ1 
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o 



Name of phase 
to be fetched 
(always begins 
$$ABERRA) 



8 



Branch address 
to retry the 
the failing 
operation 



10 



11 



Branch address 
to ignore the 
error 



12 



13 



Branch address 
to cancel the 
task 



14 



15 



Return address 
for A-transient 



First error queue entry 



V_ 



^ 



ERROR 
QUEUE TABLE 

ERRQ1 



V 

The A-transient loads one of these address in 
register 14 before branching to the return address 
(see bytes 14-15). 



Flag byte ■ 



PUB address 



10 



12 



1516 



-Message code 



Disk seek address 



19 20 



csw 










CCB 
Address 


Sense data or 
Altern. entry name 



/ 



/ 



/ 



/ 



/ 



/ 



/ 



\ 



\ 



\ 



N 



\ 



o 



o 



Bytes 0- 7: 
Bytes 8- 9: 
Byte 10 



CSW 

Address of PUB for device in error. 



Flag byte: 



BitO 
1 
2 
3 
4 
5 
6 
7 



1= No record found on DASD 

1= Intervention required 

1= Passback (Set by device ERP) 

1= Allow ignore 

Not used 

1= Allow retry 

Not used 

1= Active entry. 



Byte 1 1 



Bytes 1 2-1 5 
Bytes 1 6-1 9 
Bytes 20-43 



Message code: may refer to a device error recovery message generated 
by physical IOCS. (See DOS/VS Messages manual.) 



This location may contain one of the following: 

X'E2' = The error is recoverable. 

X'AE' = A record is to be recorded on the system recorder file for SVC44 

or a BTAM appendage routine, and a Physical Transient is to be fetched 

(last two characters of phasename are in bytes 20-21 ). 

Disk seek address 

Address of CCB 

Sense data: The number of sense bytes generated depends on the options 
specified; the minimum is 24 bytes. 



Alternate entry name: If byte 11 contains X'AE', bytes 20-21 contain the last 
two characters of the phase name of the Physical Transient to be fetched for 
SVC 44 (A3) or BTAM (A5). 

X'AF' in byte 22 indicates that the I/O area associated with an alternate entry has 
been fixed temporarily 



Figure 4.16. Explanation of the contents of the Error Block and an entry in the Error Queue 
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The data management facilities of DOS/VS are provided for by a group of routines 
collectively referred to as input/output control system (IOCS). A distinction is 
made between two types of routines: 

1. Physical IOCS (PIOCS). The physical unit I/O routines included in the 
supervisor. 

2. Logical IOCS (LIOCS). The logical unit I/O routines linked with the user's 
problem program. 



Physical IOCS 

Physical IOCS controls the actual transfer of data between the external medium 
and real storage. It performs the functions of initiating the execution of channel 
commands and handling associated I/O interrupts. Physical IOCS consists of the 
following routines: 

• Start I/O routine 

• I/O interrupt routine 

• Channel scheduler 

• Device error routines. 



Logical IOCS 

Logical IOCS performs the functions a user needs to locate and address a logical 
record for processing. A logical record is one unit of information in a file of like 
units, such as one employee's record in a master payroll file, one part number in an 
inventory file, or one customer account record in an account file. One or many 
logical records may be included within one physical record, such as a physical tape 
record (gap-to-gap). The term logical IOCS refers to the routines that perform the 
following functions: 

• Blocking and deblocking records 

• Switching between I/O areas when two areas are specified for a file 

• Handling end-of-file and end-of-volume conditions 

• Translating American National Standard Code for Information Interchange 
(ASCII) into Extended Binary Coded Decimal Interchange Code (EBCDIC) 
on input, and EBCDIC into ASCII on output 

• Checking and writing labels. 

A user's problem program normally uses LIOCS for file processing (this applies 
also to programs using POWER and VSAM files). LIOCS uses PIOCS to perform 
the data transfers. Figure 4.17 (opposite) illustrates the relationship between LIOCS 
and PIOCS using the GET macro instruction in a user program. 



•4 ^\ 



\ 



G 
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PROBLEM 
PROGRAM 




LOGICAL 
IOCS 




PHYSICAL 
IOCS 




I/O 
DEVICE 




Provide a new 
logical record from 
a physical block in 
the I/O area 

• (deblock) 


Determine channel 
and: 

a) If channel is not 


. Start device 

I 

Data transfer 

\ 

I/O complete 


Issue READ 

request (refer 

to the file 

description 

elsewhere 

in the program). 






' 


> 


to the 
problem program, 

OR 
If actual input is 
required (new 


block), issue a 
physical read 
request (EXCP. 






AND { 

WAIT 

\ 

When I/O is com- 
plete, provide the 
first (or only) 
logical record from 
the new block in 
the I/O area to the 










b) If channel is busy, 
place request into 
channel queue and 
return to LIOCS. 






(Supervisor will 
retry later.) 


♦ 

When I/O is com- 
plete, return to 
LIOCS via interrupt 






* 

Next instruction 
after READ 
request. 




program. 








handling routine 
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Figure 4. 1 7 Example of LIOCS and PIOCS interrelationship. 



Explanation of Figure 4.17: 

Logical IOCS makes a request to physical IOCS to start an I/O operation by means 
of the EXCP macro instruction. From information in the CCB, physical IOCS 
determines the channel for which the request was made and places the request on 
a queue for that device. If the channel(s) or device is not busy, the I/O is started 
and control returns to the problem program. If the channel is busy, control 
returns to the supervisor task selection routines, but the I/O request waits in the 
channel queue. When the request reaches the top of the channel queue, the I/O 
is started. 

Control returns to the program requesting the I/O unless there was an error 
condition detected on the START I/O (SIO) instruction. The problem program 
normally continues processing until it requires that the requested I/O operation 
be complete (either the information being read into real storage is needed, or the 
output area must be freed on an output operation). At this time, the WAIT macro 
causes the now waiting task to be removed from task selection until the proper 
interrupt is processed for this device by the supervisor. 
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Using PIOCS and LIOCS Macro Instructions. 



By use of macro instructions you can create, access and maintain files at both 
physical and logical IOCS levels. Through these macro instructions, the user can 
communicate with the pre-written routines and tailor them to his needs. 

As part of most user programs, LIOCS provides an interface between user programs, 
LIOCS provides an interface between user's file processing routines and PIOCS. 
(All COBOL, FORTRAN, RPG II,PL 1 OPT and PL/I(D) programs use LIOCS; 
most assembler programs use LIOCS.) 






Using PIOCS 

Using PIOCS requires a detailed knowledge of device control and system operation. 
A channel program using the CCW assembler instruction must be written in con- 
junction with three macro instructions provided to communicate with PIOCS. 

CCB: This macro instruction generates a command control block. (Refer to 
Chapter 5 in this Section for a description of the CCB.) 

EXCP: This macro instruction is converted to an SVC to request execution of 
the channel program. It supplies the location of the corresponding CCB 
to the supervisor. 

WAIT: This macro instruction generates an SVC 7 which, tests CCB byte 2 bit 
(traffic bit) to determine when an I/O operation is complete. If the 
operation is not complete, the supervisor gets control until PIOCS within 
the supervisor sets the traffic bit to indicate completion of the operation. 
The WAIT macro should always be used for each I/O operation. 

A channel program written to make use of the RPS feature of a direct-access 

device must contain Set Sector commands and either Read Sector commands or the 

SECTVAL macro instruction. 

SECTVAL: This macro instruction generates an SVC 75 to supply the 
sector in which the record is located. 

For information on the format of Sector CCWs and on Rotation Position 

Sensing see the Appropriate reference manuel for the device. 






The example below shows part of an assembly program listing using the EXCP 
WAIT and CCB macros. A full description of these MACRO instructions can be 
found in DOS/VS Supervisor and I/O Macros. 



























• 


003B00 


47F0 


BT5C 


03F5E 


261 


^^^^^^^^^^SKI^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^KM 


















262 


»««»»»»*»**««»»»«»»«»***»»«»»»*»«*«»«»«**»*******«**«***««»♦♦»*«»»*»**« 




















263 


•BUG GENERATOR ROUTINE* 










• 










264 


***»»»»»»»*«*»**•»**»«««**«*»*»***»»»•*»»»*»»«»*»**«***«»«»«»»*««»»*«»» 










003B04 


5010 


C61E 


04E20 


265 


BUG ST 1.R1SAVE SAVE CONTENTS OF RETURN REGISTER 




















266 


EXCP TCCB1 










• 










270 


WAIT TCCB1 


















276 


EXCP TCCB2 




















280 


WAIT TCCB2 










• 


003B30 


9640 


C83F 


05041 


286 


01 OPRESPltX'40* 










003B34 


9503 


C83F 


050*1 


287 


CLI OPRESPltC'L 1 


Ov 


g3j&} 























004E90 4040404040404040 



004EBA 
004ECO 
004EC8 
004ED0 
004E08 
004EE0 
004EE8 
004EF0 
004EF8 
004F00 
004F08 



000000000000 

09004F106000001C 

09004F2C60000020 

09004F4C6000002F 

09004F7B6000001F 

09004F9A60000021 

09004FBB60000021 

09004FOC60000020 

09004FFC60000020 

0900501C20000025 

OA00504120000001 



1348 


TOWN 


DC 


CLIO 1 • 


1349 


TCCB1 


CCB 


SVSLOGtTCCWltX , 0400> 


1360 


TCCB2 


CCB 


SVSLOG f TCCW2,X , 0400' 


1371 


TCCW1 


CCW 


09,MSSG1,X , 60',28 


1372 




CCW 


09,MSSG2,X'60',32 


1373 




CCW 


09,MSSG3,X , 60',47 


1374 




CCW 


09.HSSG4,X I 60'.31 


1375 




CCW 


09,MSSG5,X , 60>,33 


1376 




CCW 


09,MSSG6,X'60',33 


1377 




CCW 


09,MSSG7,X , 60',32 


1378 




CCW 


09,MSSG8,X , 60 , ,32 


1379 




CCW 


09,MSSG9,X , 20 , t 37 


1380 


TCCW2 


CCW 


lO.OPRESPltX^O'tl 


1381 


♦♦♦♦♦♦♦♦♦♦♦♦♦a********************************************************* 


1382 


♦MESSAGE 


CONSTANTS* 



1 
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Using LIOCS 

Logical IOCS requires a minimum knowledge of the hardware I/O devices and is 
easily implemented within the problem program by the coding of macros. This 
system is also used by most of the high-level languages to control I/O operations. 

Two types of macro instructions are available to communicate with LIOCS. 

• Imperative Macros 

These macros order an action to be performed. For example, the macro GET 
commands LIOCS to place the next record in the user's problem program area. 

• Declarative Macros 

These macros supply information about the file and about types of processing the 
I/O routine will have to perform for the user. 
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Imperative Macros 

The problem programmer issues imperative logical IOCS macro instructions to 
initiate such functions as opening a file, making records available for processing, 
writing records that have been processed, and controlling physical device operations. 
A full list can be found in DOS/ VS LIOCS Vol 1. 



f> 



Declarative macros DTF (Define the File) Macros 

For each imperative macro issued by the problem program, the assembler program 
generates an in-line expansion that links the instruction to the DTF table (and 
consequently, the logic module) for the specified file. As an operand, the imperative 
macro instruction must always contain the filename in the DTF macro describing 
the file. 

For VSAM files, the DTF macro is replaced by the ACB, EXLST and RPL macros 
to describe a file. 

Whenever logical IOCS imperative macro instructions are used in a problem program 
to control the transfer of records in a file, that file must be defined by a declarative 
DTF macro instruction. The DTF macro instruction describes (through various 
parameters specified by the problem programmer) the characteristics of the logical 
file, indicates the type of processing for the file, and specifies the virtual storage 
areas and routines, Figure 4.19 summarizes the various DTF table types supported 
by DOS/VS. Detailed descriptions of the logical IOCS file definition (DTF) macros 
and their parameters are described in Supervisor and I/O Macros. 

When one of these DTF macro instructions is encountered at assembly time, the 
assembler builds a DTF table tailored to the DTF parameters. The table contains: 

• Device CCB 

• A V-type address constant used by the Linkage Editor to resolve the linkage to the 
logic module with this DTF 

• Logic indicators; that is, one I/O area, two I/O areas, device type, etc. 

• Addresses of all of the areas (except work areas) and control functions used by 
this device. 
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Regardless of the method of assembling logic modules and DTF tables (that is, 
together with the main program or separately), a symbolic linkage results between 
the DTF table and the logic module. The Linkage Editor resolves this linkage at 
edit time. 






Byte 


Bits 


Function 


0-15 




CCB. 


(0-F) 






16 




X'08' indicates DTF 


(10) 




relocated by OPENR. 


17-19 




Address of logic module. 


(11-13) 






20 




DTF type (X'10') 


(14) 






21 





1 = No rewind. 


(15) 


1 


1 = Unload rewind. 




2 


1 = Workfile. 




3 


1 = Read backward. 




4 


1 = Write. 




5 


1 =PCINTW. 




6 


1 = Force checking of read or write. 




7 


1 = Forward space before next operation. 


22-23 




Not used. 


(16-17) 






24-25 




Record length. 


(18-19) 






26-27 




Maximum BLKSIZE. 


(1A-1B) 






28 




Read op code. 


(1C) 






29-31 




EOF address. 


(1D-1F) 






32-39 




CCW. 


(20-27) 






40-43 




Block count, initialized 


(28-2B) 




00000000 for read 
forward, 

00400000 for read 
backward. 


44 





1 = Error routine. 


(2C) 


1 


1 = Ignore. 




2 


1 = Read next record switch. 




3 


1 = Record fixed unblocked. 




4 


Not used. 




5 


Not used. 




6 


Not used. 




7 


Not used. 


45-47 




Address of error routine. 


(2D-2F) 







J 



Note: Numbers in parentheses are displacements in hexadecimal 
notation. 

Figure 4.18. The format of the DTF table generated by a DTFMT declarative 
macro for a DTFMT workfile. 



An example of an assembly program listing is shown in Figure 4.22 that shows the 
expansion of a DTFMT macro. The macro expansion was obtained by the use of 
the assembly control statement PRINT GEN (a useful aid to use when in doubt). 
Figure 4.23 shows how this same DTFMT is printed in a system dump. The table of 
Figure 4.19 (opposite) lists all the DTF codes and relates them to their specific 
files. 
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(Byte 20) 


DTF 


Description 




of DTF Table 








X'OO' 




DTFCD 


Combined files 




x'or 




DTFPT 


Paper tape files 




X'02' 




DTFCD 


Reader and 3881 Optical Mark Reader files 




X'03' 




DTFCN 


Console 




X'04' 




DTFCD 


Punch files 




X'08' 




DTFPR 


Printer files 




X'09' 




DTFOR 


Optical Reader files except 3881 files 




X'OA' 




DTFOR 


Optical Reader files (HEADER=YES) 




X'OB' 




DTFMR 


Magnetic Ink Character Recognition (MICR) and Optical Reader/Sorter files 




X'OC 




DTFDR 


3886 Optical Character Reader files 




X'10' 




DTFMT 
DTFCP 


Magnetic tape workfiles 

Magnetic tape workfiles (compiler). (Note 1 ) 




x'ir 




DTFMT 


Nonstandard or unlabeled tape files 




X'12' 




DTFMT 
DTFPH 


Standard labeled, output tape files 

Standard labeled, output tape files (physical IOCS) 




X"I3' 




DTFMT 


Standard labeled, input tape files (read backward) 




X'14' 




DTFMT 


Standard labeled, input tape files (read forward) 




X'1A' 




DTFDU 


Diskette I/O Unit files 




X'20' 




DTFSD 
DTFCP 


Sequential DASD workfiles and data files 
DASD workfiles (compiler) 




X'21' 




DTFPH 


Sequential DASD files, MOUNTED=SINGLE (physical IOCS) 




X'22' 




DTFDA 


Direct access files 




X'23' 




DTFPH 


Direct access files, MOUNTED=ALL (physical IOCS) 




X'24' 




DTFIS 


Indexed sequential, LOAD file 




X'25' 




DTFIS 


Indexed sequential, ADD file 




X'26' 




DTFIS 


Indexed sequential, RETRVE file 




X'27' 




DTFIS 


Indexed sequential, ADDRTR file 




X'28' 




ACB 


Access Method Control Block for VSAM files 




X'30' 




DTFCP 


Compiler file for DOS Version 1 (Note 1 ) 




X'31' 




DTFCP 


Compiler file for DOS Versions 2 and 3 




X'32' 




DTFCP 


Compiler file for DOS Versions 2 and 3 (Note 2) 




X'33' 




DTFDI 


Device independent system unit files 




X'40' 




DTFBT 


Basic Telecommunications Access Method (BTAM) file (Notes 3 and 4) 




X'50' 




DTFQT 


Queued Telecommunications Access Method (QTAM) file (Notes 3 and 4) 




X'60' 










through 






Reserved 




X'67' 










Note 1: 


DTF type is X'30' except for tape or DASD assigned to units SYS000 to SYSnnn. In this case, the DTFCP open 




phases change the DTF type to X'W for tape workfiles, or X'20' for DASD work files. 




Note 2: 


DTF type is X'32' except for DASD assigned to units SYSOOO to SYSnnn. In this case, the DTFCP open 
change the DTF type to X'20' for DASD workfiles. 


phases 


Note 3: 


The following control unit codes are ORed into the low-order 4 bits of the DTF type code. 
Control Unit Code 
7770 1 

2848 3 

2701 4 

2702 5 

2703 6 




Note 4: 


The DTF tables for BTAM and QTAM files are not documented in this manual. They are documented in 
publications DOS/VS BTAM Logic and DOS/VS QTAM Logic. 


the respective 


Note 5: 


VSAM differs from other DOS/VS access methods in that it does not use a DTF. The declarative macro equivalent for 




VSAM is the ACB. (Access Control Block). 





©' 



Figure 4.19. DTF type codes. 
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MOD (Module Generation) Macros 

To speed up assembly time and save storage, LIOCS uses another type of 
declarative macro instruction. Called logic module generation macros, declaratives 
of the form xxMOD describe the type of processing that the I/O routines will 
have to do for a particular file. A module is generated that handles only what the 
user has specified. 

The module generation macros generate the data handling logic modules. These 
modules contain generalized routines needed to perform the functions of the 
logical IOCS imperative macros. The generalized routines in the logic modules are 
altered and made more specific through various parameters (specified by the 
problem programmer) included in the xxMOD macro statements. It is possible, 
therefore, to generate many variations of a particular type of logic module, each 
specifically suited to the need of the problem programmer. 

At assembly time, the assembler produces an EXTRN (External Symbol) card for 
every V-type constant (or EXTRN statement) in the user program. The assembler 
expansion of the DTF statement produces an EXTRN card with the name of the 
logic module needed to support the parameters that were specified in the DTF 
macro. The IBM-generated module names indicate the type of file and the support 
that each is capable of supplying for the DTF. Refer to Figure 4.20 for a breakdown 
of these names. Because of the descriptive nature of the IBM standard names, the 
programmer should be careful when specifying his own names for the logic modules 
to avoid overriding the IBM standard names. At the time this program is link- 
edited, the linkage editor resolves these EXTRN symbols (AUTOLINK). If the 
program is not to be executed immediately, option CATAL causes'the linkage 
editor catalogs the program into the core image library. 



1 


H 
J 
K 


xxxxxx 




L 






rlJB 


System Service and System Control 




IJC 


Card logic 




IJD 


Printer logic 




IJE 


Paper tape logic 


DATA < 


IJF 


Magnetic tape logic 


MANAGEMENT 


IJG 


Sequential DASD logic 




IJH 


Indexed Sequential DASD logic 




IJI 


Direct Access DASD logic 




LlJJ 


Device independent logic 




r UL 


Teleprocessing routines 




IJM 


Optical Reader logic 


DATA J 
MANAGEMENT | 


UN 
JJU 


Diskette I/O Unit logic 
Magnetic Readers logic 




IJW 


Utilities 




IJZ 


OLTEP 




IKQ 


VSAM 



o 



Figure 4.20. A list of module names and their prefixes. 

Reentrant modules 



A re-entrant module is a logic module that can be used asynchronously, or shared 
by more than one file. The RDONLY (read only) parameter implies that the 
generated logic module is never modified in any way, regardless of the processing 
requirements of any file(s) using the module. To provide this feature, unique save 
areas external to the logic module are established, one for each task using the 
module. Each save area must be 72 bytes and doubleword aligned. Before a logic 
module is entered or an imperative macro is issued to the file, the task must provide 
the address of its unique save area in register 13. 
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Interrelationships of the DTF and Module Macro Instructions 

The DTFCD, DTFDA, DTFDI, DTFDU, DTFMR, DTFMT, DTFOR, DTFPR, 
DTFPT, and DTFSD declarative macros are similar in that each of them generates 
a DTF table that references an IOCS logic module. The first 16 bytes of each table 
have the same format, that is, a command control block (CCB) and bytes 17 to 19 
contain a logic module address. The length of each table depends on the particular 
device and file type. Figure 4.19 lists the DTF device codes. To accomplish the 
linkage between the DTF table and the logic module, the assembler generates a 
V-type address constant in the DTF of a named CSECT in the logic module. To 
resolve this linkage, the linkage symbols (module names) must be identical. The 
Figure below shows the relationship of the program, the DTF, and the logic 
module. The assumed parameters have generated a request for a MTMOD named 
IJFFBCWZ. Based on this name, the linkage editor was able to locate the module. 
The GET statement generated coding to load the address of the DTF table into 
register 1 . This gives the program access to the MTMOD address, and the program 
branches to the required routine within the module. 
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Problem Program 



GET TAPE 




DTF Table 



TAPE DTFMT 



Module 



IJFFBCWZ MTMOD 



DC V(IJFFBCWZ) 



Figure 4.21 The relationship between imperative and declarative macros. 

See also Figure 4.24 
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PAGE 15 


IOC 


OBJECT CODE AD0R1 


AD0R2 


STMT SOURCE 


STATEMENT DOS/VS ASSEMBLER REL 29.0 


20.02 73-10-05 








664 TAPEOUT 


DTFMT 


BLKSIZE-800, 

DEVADDR-SYS003, 

FILABL'NO, 

I0AREA1-RITETAPE, 

RECFORM-FIXBLK, 

TYPEFLE-OUTPUT, 

WORKA-YES, 

RECSIZE«80 




C 
C 
C 
C 
C 
C 
C 
C 








665 + » MAGNETIC TAPE IOCS - OTFMT - 5745-SC-TAP - REL. 28.0 




02250028 


003FA8 






666 + 


DC 


ODiOi 




3-8 29400025 


a 003FA8 


000080000000 




667+TAPE0UT 


DC 


x;oooo8OOOOOO0; ccb 




30300025 


w 0O3FAE 


01 




668 + 


DC 


ALK1) LOGICAL UNIT CLASS 




30400025 


003FAF 


03 




669+ 


DC 


ALIO) LOGICAL UNIT 




30500025 


f 003FB0 


00003FEO 




670+ 


DC 


AL4(IJF10060) CCW ADDRESS 




3-8 31000025 


w C03FB4 


00000000 




671 + 


DC 


4X;00s CCB-ST BYTE.CSW CCW ADDRESS 


3-8 31100025 


003FB8 


00 




672 + 


DC 


ALKO) 




3-8 31800025 


£ 003FB9 


oooooo 




673 + 


DC 


VL3I1JFFZZWZ) ADDRESS OF LOGIC MODULE 




3-8 38500025 


w 003FBC 


11 




674+ 


DC 


X;ll; DTF TYPE 




39500025 


0O3FBD 


50 




675 + 


DC 


ALU 80) LOGICAL IOCS SWITCHES 




41300025 


A 003F8E 


E3C1D7C506E4E340 




676+ 


DC 


CL8;TAPE0UT; 




41800025 


W 0O3FC6 


01 




677 + 


DC 


x;01; 




42300025 


0O3FC7 


60 




678 + 


OC 


ALK96I SWITCHES FOR OPEN 




3-8 45200025 


a C03FC8 


00 




679+ 


DC 


ALKO) SWITCH ONE FOR OPEN AND 


CLOSE 47200025 


w 0O3FC9 


OOOOOO 




680+ 


DC 


AL3C0) USER LABEL ROUTINE 




47700025 


0O3FCC 


00 




681 + 


DC 


ALKO) SWITCH FOR OPEN AND CLOSE 




48600025 


a 003FCO 


003FCD 




682 + 


OC 


AL3(*) 




49000025 


C03F0O 


00000000 




683+ 


DC 


FJO; BLOCKCOUNT 




49100025 


O 003F04 


86BC F018 


00018 


684+ 


BXH 


11.12.24(15) DEBLOCKING FORWARD 




49700025 


Oa 003FD8 


41 EE 0001 


00001 


685 + 


LA 


14,1(14) INCREASE BLOCKCOUNT BY ONE 


49800025 


003 FOC 


4700 0000 00000 




686 + 


NOP 


0(0) LOAD USER IOREG 




50600025 


C03FE0 


010047A120000320 




687+IJF 10060 




CCW x;01;,RITETAPE,x;20;,800 




55600025 


m 0O3FE8 


000047A1 




688 + 


DC 


A(RITETAPE) ONE IOAREA 




3-10 56160026 


w 003FEC 


000047A1 




689+UF20060 




DC A(RITETAPE) DEBLOCKER 1 




3-10 52050026 


003FFO 


00000050 




690+ 


DC 


F;80; DEBLOCKER 2 




3-10 52100026 


a 003FF4 


00004ACO 




691 + 


DC 


A(«ITETAPE+800-l) DEBLOCKER 3 




3-10 52150026 


W 0O3FF8 


0320 




692 + 


DC 


YI800) BLOCKSIZE 




52400025 


C03FFA 


031F 




693 + 


DC 


V(800-l) BLOCKSIZE-1 




52600025 


A C03FFC 


004F 




.694+ 
695 


DC 
MTMOD 


Y(80-l) RECSIZE-1 
WORKA=YES 




3-8 52900025 








696+» MAGNETIC TAPE IOCS - MTMOD - 5745-SC-TAP - REL. 29.0 


/DL29ZCN 00280029 


f oooooo 






697+IJFFDTF 


DSECT 






03160025 


w oooooo 


OOOOOOOOOOOOOOOO 




698+IJFFNM 


DC 


4F;0i CCB 




03200025 






00003 


699 + IJFFCB2 


EQU 


IJFFNM+3 COMMUNICATION BYTE 2 




03240025 


a 000010 


00000000 




700+ 


DC 


AIO) ADDRESS OF LOGIC MODULE 




03480025 


000014 


10 




701 + 


DC 


X;10; DTF TYPE 




03520025 


000015 


00 




702+IJFFSWI 


DC 


X;00; LOGICAL IOCS SWITCHES 




03560025 


A 000016 


C6D5C104C5404040 




703+ 


DC 


CL8;FNAME ; 







o 



Figure 4.22. An example of an assembly listing showing the expansion of a 
DTFMT macro instruction. 

The program was assembled using the PRINT GEN assembler control statement 




Figure 4.23. An example showing how the same DTFMT is printed in a dump. 
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ERROPT=YES, 
READ=FORWARD, 
RECFORM=FIXUNB, 
TYPEFLE=INPUT 



Figure 4.24. A summary of the relationships between an imperative macro, a declarative macro, and a module 
generation macro specified in a program. 

The GET imperative macro is used in this illustration, which also shows the linkage between the generated DTF table and the 
logic module. 
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RPS (Rotational Position Sensing) Option 

System Support 

RPS support for devices attached to block multiplexer channels in full block 
multiplex mode (or their equivalent on Model 31 15/3125 CPUs) is provided as an 
option in DOS/ VS. The option is specifiable at the operating system and device 
level. System support is provided at system generation time by coding the FOPT 
macro with RPS=YES. The IBM 3330/3333 supports RPS as a standard feature. 
The IBM 3340 supports RPS when 3340R is specified in the DVCGEN macro. 
Please note that Block Multiplexing cannot be used with the 231 1-1/3330, 
231 1-1/3340, and 2314/3340 Series Compatibility Features, if your CPU is a 
Model 31 15 or a Model 3125. 

Data Management Support 

RPS support will be provided dynamically in Data Management when the 
operating system and the device support and all of the following conditions are met: 

• One of the DASD access methods is being used, that is, the file is defined by one 
of the following DTFs: DTFSD, DTFDA, DTFIS, DTFDI, or DTFPH . 

• There is room in the user's virtual storage to extend the DTF. 

• An RPS version of the logic module necessary to process the DTF has been, or 
can be, loaded into the SVA. 

At OPEN time, if it is determined that the system and the device both support 
RPS, a bit is set in the DTF tables (see Figure 4.24A). This bit will not be turned 
off until CLOSE time whether or not the other conditions for RPS support are 
met. Space is then obtained for the DTF extension. The amount is dependent on 
which access method is in use (see Figure 4.24 A). If space is unavailable, the 
DTF will be opened without RPS support. 

Determination as to which RPS logic module is required to process this DTF is 
made and the module is loaded into the SVA, unless it is already there in which 
case it is sharable across partitions. If the required logic module cannot be made 
available, OPEN releases the DTF extension space and the DTF is opened 
without RPS support. 

If the space for the DTF extenstion is available and the RPS logic module is loaded 
into the SVA, OPEN sets another bit in the DTF table indicating that the data set 
will be processed in RPS mode (see Figure 4.24A). 

The first section of the DTF extension contains the RPS channel program (so that 
the pointer to the extension is also the pointer to the RPS CCW chain). The 
extension also contains CCW build and work areas necessary to construct the RPS 
channel program, a sector value bucket, and register and address save areas (see 
Figure 4.24B for DTF extension format). 

The addresses of the original channel program and logic module are saved in the 
extension while the address of the RPS channel program is put into bytes 9 - 11 of 
the DTF and the address of the RPS logic module is put into bytes 17 - 19, These 
pointers are restored at CLOSE time. 

The original DTF is used for all fields except the channel program so that no 
mapping between the DTF and the extension is required, (see Figure 4.24C for an 
overview of the OPEN.) 
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No program recompiling or relink -editing is required, though there must be enough 
dynamically allocatable space in the user's partition for the RPS extensions. Since 
RPS gets this space via the GETVTS macro, the SIZE= parameter must be 
specified in the program's EXEC statement. 

The DTF extension provides a register save area for the RPS logic modules since 
they are all reentrant and sharable between partitions. If the original non-RPS 
logic module is reentrant because it was coded read-only, the user-supplied save 
area will not be used. The RPS logic modules are supersets of functions needed 
to process the DTF. 

System Component Support 

System Components support RPS where there is a significant amount of DASD I/O. 
This support is provided by building RPS channel commands and then changing 
these to NO-OPs or TICs if the affected device or system does not support RPS. 

Wherever the component uses LIOCS for its I/O, this optional support is provided 
through the data management support of RPS. 

Where LIOCS is not used, the component logic interrogates the indicator set by 
OPEN for I/O using DTFPH or, when DTFPH is not used, the same PUB and 
COMREG indicators interrogated by OPEN. 
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The system components supporting RPS are: 

• POWER 

• Supervisor Fetch and Paging I/O 

• Linkage Editor 

• Job Control 

• Librarian 

• Checkpoint/Restart 

• System Utilities 





DTFDA 
DTFPH* 


DTFSD 
DTFPH* 


DTFSD 

(work 

files) 


DTFDI 


DTFIS 
(All) 


DTF offset: set at byte 


32(20) 


44 (2C) 


37(25) 


42(2A) 


65(41) 


System supports 
RPS bit 


1 


1 


1 


7 


4,7# 


DTF has been 
extended bit 


7 


7 


7 


1 


5 


Length of DTF 
extension 


512 


256 


256 


256 


384 



* DTFPH has no logic module; therefore, the only RPS processing done is the setting of the 
System Support RPS bit. 

# Bit 4 on - prime data resides on an RPS device 
Bit 7 on - index resides on an RPS device 

Figure 4.24A. DTFs for RPS Support 
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0(0) 



RPS Channel Program 
(variable length) 






Work Space 



176(B0) Address of Original Channel Program 180(B4) Address of Original Logic Module 



172(AC) 



Sector Values (up to 4) 



184(B8) 



72-Byte Register Save Area 



256(100) 



T 



Additional Work Space 

not present for SAM or Device Independence 

(This field is 256 bytes for DAM and 128 bytes for ISAM) 



x__y 



Figure 4.24B DTF Extension Work Area for RPS 
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BEFORE OPEN 
(and after CLOSE) 



AFTER OPEN 





USER'S PROGRAM 
DTF 




1 


CCB CCW ^ 
- - MOD f J 




1 1 
1 1 




Channel Program 






!--► 


Non-RPS module 
(LIOCS module refer- 
red to by the DTF 
and link-edited with 
user's program 









USER'S PROGRAM 
DTF 



CCB CCW 



'♦ 



MOD* 





USER'S VIRTUAL STORAGE 



RPS CHANNEL PROGRAM 



(see Figure 4.24B) 



I 

| SHARED VIRTUAL AREA 



I 
l 
I 

L_ 











RPS LIOCS 
Module 











N\ 



Figure 4.24C Effect of RPS Support on OPEN 
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VSAM (Virtual Storage Access Method) I/O 

VSAM IOCS differs from that of other DOS/VS access methods as follows: 

• VSAM declarative macros are ACB, EXLST, and RPL instead of DTF and 
xxMOD. 

• VSAM routines are dynamically loaded into virtual storage when a VSAM 
file is opened. They are not assembled or link edited with the user's 
program. 

Declarative Macros 

The VSAM declarative macros are ACB, which creates an Access-Method Control 
Block; EXLST, which creates an Exit List; and RPL, which creates a Request 
Parameter List. The Access-Method Control Block (ACB) is like a DTF in that it 
defines the file to be processed. Opening a VSAM file involves opening the ACB 
for that file. The Request Parameter List (RPL) defines the parameters necessary 
for a particular execution of a request (imperative) macro. It contains some of the 
information, such as address of the user's work area, located in the DTF in other 
access methods. The Exit List (EXLST) contains the addresses of optional user 
exit routines. Up to four exit routines can be specified— one for handling end-of- 
file, one for handling logical errors, one for handling I/O errors, and one to allow 
user processing during VSAM I/O operations. 

Codes indicating errors resulting from execution of imperative macros are set in 
registers or in the ACB or RPL as described below. 

Imperative Macros 

The user's program issues imperative macros to open or close a file and to retrieve, 
add, delete, or update records. It can also issue imperative macros to generate, 
modify, display, or test the control blocks created by the declarative macros. When 
control is returned to the user's program after execution of an imperative macro, a 
"return code" is set in the low-order byte of register 15. The return code indicates 
the results of the macro execution. If an error or certain other exceptional 
conditions occur, an "error code" will be set in the ACB, the RPL, or in register 0, 
depending on the macro. Figure xx summarizes the return codes and error codes 
issued by the imperative macros and user exit routines which can be used. More 
information on the return codes and user exits as well as a complete list of the error 
codes and their meanings is in the VSAM chapter of DOS/VS Supervisor and I/O 
Macros. 

An ACB, EXLST, or RPL can be created dynamically, during program execution, 
by using the GENCB macro. The fields in these control blocks can be modified 
during program execution by using the MODCB macro. Refer to DOS/VS 
Supervisor and I/O Macros for information on how to write the GENCB and 
MODCB macros. 

RPL Debugging Hints 

If the RPL hold byte, 35(23), is set to X'FF', the error occurred while the request 
was being executed by VSAM. Check the type of request byte, 29(1D), to 
determine what request was active. If the request was a POINT, GET, or PUT, 
check the following parameters in the RPL (of GENCB for RPL) in your program 
to ensure that they are valid: 

Macr o Check these RPL Parameters 

POINT ARG and KEYLEN 

GET AREA and AREALEN 

IF OPTCD=DIR or OPTCD=SKP, also check ARG and KEYLEN 

PUT AREA and RECLEN 

If the RPL parameters are specified correctly or if the type of request is other than 
POINT, GET, or PUT, the error is probably in VSAM itself. Save the dump, console 
log, and program listing and contact your IBM programming support representative. 

Note: MODCB, SHOWCB, and TESTCB macros also set the RPL Hold byte. If this 
byte was set by one of those macros, the type of request byte will have no meaning. 



\^' 
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Imperative 
Macro 


Return Code 
found in 


If Return 
Code no 0, 
Error Code 
found in 


Method of 
Inspecting 
Error Code 


Exits Taken if User Exit 
Routines are Supplied 


OPEN 

CLOSE 

TCLOSE 


Register 
15 


ACB 


Code ERROR 
parameter 
in TESTCB** 
or SHOWCB 


SYNAD EXIT FOR 
I/O errors in 
CLOSE; code 
FDBK in TESTCB** 
or SHOWCB 


GET 

PUT 

POINT 

ERASE 

ENDREQ 


Register 
15 


RPL 


Code FDBK 
parameter 
in TESTCB** 
or SHOWCB 


LERAD exit for 
logical errors* 
(Return Code 
is X'08') 
SYNAD exit for 
I/O errors 
(Return Code 
is X'OC) 


GENCB 
SHOWCB 
TESTCB 
MODCB 


Register 
15 


Register 



Inspect 

Register 




None 



\J 



* End-of-file is indicated by an error code of X'04'. The EODAD exit is taken if an EODAD routine is supplied. 
Otherwise, the LERAD exit is taken. 

** A user routine can be supplied to receive control if NSAM is unable to test for the condition specified because of 
an error occurring during execution of the TESTCB macro. The routine is pointed to by the ERET parameter 
of TESTCB. 

Figure 4.25. Summary of Error Checking for VSAM Imperative Macros 



Error Detection with VSAM Macros 

When an error occurs, the user can either attempt to correct it in his program, close 
the file, or terminate the job. These actions can be taken in the SYNAD and LERAD 
exit routines or in-line in the program. If the user wants to evaluate the error 
condition after the job has finished, he should write the error code in a field in 
his program (for locating it in a dump output) or in a message. He obtains the error 
code from the ACB or the RPL by issuing either a TESTCB or a SHOWCB macro. 

The SHOWCB macro is used to display the contents of an ACB, EXLST, or RPL 
in a work area specified by the user. The contents include the fields coded for each 
block by the user. An ACB also includes fields, such as number of levels in the 
index, read from the file's catalog entry when the file is opened. The TESTCB 
macro is used to test the value of a field or a combination of fields in the ACB, 
EXLST, or RPL. See the Supervisor and I/O Macros publication for information 
on how to write the SHOWCB and TESTCB macros. 

The SHOWCB and TESTCB macros can also be used when a task terminates 
abnormally (such as through a program check). The VSAM macro can be included 
in a routine called by the STXIT macro instruction. 
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VSAM Control Blocks 

When a VSAM file is opened, VSAM uses the information supplied by the user in 
the ACB, EXLST, and RPL along with information in the file's catalog entry to 
construct VSAM control blocks. The contents of the EXLST, RPL and ACB control 
blocks are shown in Figures 4.25 .B, C and D. Additional control blocks internal to 
VSAM are pointed to by the ACB and RPL and are described in DOS/VS LIOCS 
Logic, Volume 4: VSAM. 



REGISTER '1 



to RPL 






AMBL 


ACB 


Points to 
internal 
VSAM 
control blocks 


AMBL 
EXLST 


m 




EXLST 













Figure 4.25.A. Relationship of VSAM Control Blocks 


Displacement 
dec (hex) 


Length 
in bytes 


Description and/or Contents 


0(0) 


1 


Control block identifier — X'81 ' 


1(1) 


1 


EXLST active byte. Set to X'FF' when file is open. 


2(2) 


2 


Length of EXLST. The length will be 10 bytes, 15 bytes, 
or 20 bytes. 


AtA\ 


1 


Reserved 


5(5) 


1 


EODAD entry flags: 

X'80' — Entry present 

X'40' — Entry active 

X'20' — Entry to be dynamically loaded 


6(6) 


4 


Address of the user's EODAD exit routine. 

Set from the EODAD parameter of the EXLST macro. 


10(A) 


1 


SYNAD entry flags: 

X'80' — Entry present 

X'40' — Entry active 

X'20' — Entry to be dynamically loaded 


1KB) 


4 


Address of the user's SYNAD exit routine. Set from the 
SYNAD parameter of the EXLST macro. 


15(F) 


1 


LERAD entry flags: 

X'80' — Entry present 

X'40' — Entry active 

X'20' — Entry to be dynamically loaded 


16(10) 


4 


Address of the user's LERAD exit routine. Set from LERAD 
parameter of the EXLST macro. 


20 (14) 


1 


EXCPAD entry flags: 

X'80' — Entry present 

E'40' — Entry active 

X'20' — Entry to be dynamically loaded 


21 (15) 


4 


Address of the user's EXCPAD exit routine. 

Set from EXCPAD parameter of the EXLST macro. 



'VI J 



Figure 4.25.B. Explanation of the contents of the EXIT LIST (EXLST) 



\y 
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Displacement 
dec (hex) 


Length 
in bytes 


Description and/or Contents 


0(0) 


1 


Control block identifier — X'OO' 


1(1) 


1 


X'OO' 


2(2) 


2 


Length of RPL 


4(4) 


4 


Relative Byte Address (RBA) of last record process or DD field indicator. 


8(8) 


4 


Address of the, key or RBA which is the search argument. Set from ARG parameter or RPL or GENCB 
macro. 


12(C) 


4 


Address of user's work area which contains the logical record. Set from AREA parameter of RPL or 
GENCB macro. 


16(10) 


4 


Length of the last logical record processed. Set from the RECLEN parameter of RPL or GENCB macro 
and modified (for variable length records) by the user for a PUT macro and by VSAM for a GET macro. 


20(14) 


4 


Length of the user work area. Set from the AREALEN parameter of RPL or GENCB macro. 


24(18) 


4 


Address of the ACB 


28(1 C) 


1 


X'01' 


29(1 D) 


1 


Type of current request: 
X'OO'- POINT macro 
X'04'- GET macro 
X'08'- ERASE macro 
X'OC- PUT macro (update) 
X'10'- PUT macro (insert) 
X'18'- Internal VSAM request 






X'lC- ENDREQ macro 

X'20' to X'24'- internal VSAM requests 


30(1 E) 


2 


Key length 


32(20) 


1 


First byte of option codes (set from OPTCD parameter of RPL of GENCB macro): 

X'80'— Keyed access 

X'40'— Addressed access 

X'20'— Sequential processing 

X'10'— Direct processing 

X'04'— Skip sequential processing 

X'02'— Control interval access 

X'01'- Update 


33(21) 


1 


Second byte of option codes: 

X'80'— Search key greater than or equal 

X'40'— Generic key request 

X'20'— Note string position 

X'10'- No update 

X'08'— Locate mode 

X'04'— User buffer processing 


34(22) 


1 


RPL available byte. If set to X'FF" the RPL is not available for a request. If set to X'00', the RPL is 
available for a request. 


35(23) 


1 


RPL hold byte. If set to X'FF', the RPL is active (a request has been started but has not been completed). 
If set to X'OO', the RPL is not active (no requests are in process). 


36(24) 


1 


X'FF' 


37(25) 


1 


Return code (also set in Register 15). See Supervisor and I/O Macros for a description of return codes. 


38(26) 


1 


Reserved 


39(27) 


1 


Error code (describes the type of error detected by VSAM). See Supervisor and I/O Macros for a 
description of the error codes. 


40(28) 


4 


Address of the Placeholder (PLH). This is an internal VSAM control block and is described in 
DOS/VS LIOCS Logic Volume 4: VSAM. 


44(2C) 


8 


Reserved 



Figure 4.25.C. Explanation of the contents of the REQUEST PARAMETER LIST (RPL) 
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Displacement 
dec (hex) 


Length 
in bytes 


Description and/or Contents 


0(0) 


1 


Control block identifier - X'AO' 


1(1) 


1 


ACB active byte. Set to X'FF' when ACB is open. 


2(2) 


2 


Length of ACB 


4(4) 


4 


Address of the Access Method Block List (AMBL). This is an 
internal VSAM control block and points to other internal 
VSAM control blocks. They are described in DOSA/S 
LIOCS Logic Volume 4: VSAM. 


8(8) 


4 


Address of the VSAM load module (VSAM routines). 


12(C) 


2 


Reserved 


14(E) 


2 


Number of data buffers 


16(10) 


2 


Number of index buffers 


18(12) 


1 


MACRF first byte: 
X'80' — Keyed access 
X'40' — Addressed access 
X'20' — Control interval access 
X'10' — Sequential processing 
X'08' — Direct processing 
X'04' - GET macro 
X'02' - PUT macro 
X'OV - User buffers 


19(13) 


1 


MACRF second byte: 

X'20' — Skip sequential processing 


20(14) 


1 


DOS/VS DTF identifier - X'28' 


21(15) 


1 


Open/Close flags 

X'10' -ACB is open 

X'01 ' — ACB will accept keyed as well as RBA requests 

Other Open/Close flags are internal to VSAM 


22(16) 


1 


x'or 


23(17) 


1 


Error code. This code describes errors that occur during Open 
Close, or TCLOSE. The codes are described in Supervisor and 
I/O Macros. 


24(18) 


4 


Size of VSAM's buffer pool 


28(1 C) 


8 


Filename of ACB. Set from label field of ACB macro or 
DDNAME parameter of ACB or GENCB macro. 


36(24) 


4 


Address of password. Set from PASSWD parameter of ACB 
or GENCB macro. 


40(28) 


4 


Reserved 


44(2C) 


4 


Address of VSAM's buffer pool 


48(30) 


4 


Address of Exit List (EXLST) 


52(34) 


4 


Reserved 



it. 



Figure 4.25.D. Explanation of the contents of the Access-Method Control 
Block (ACB) 

Note: ACB . The ACB macro produces an Access Method Control Block (ACB) 
for a VSAM file. The control block identifies the key -sequenced file and its index 
or the entry-sequenced file that is to be processed, and indicates the types of 
requests that are to be made. The ACB is similar to a DTF in that it identifies the 
file to be processed. However, most information about the file, such as key length 
and record format, is specified in the Access Method Services' (AMS) DEFINE 
command. Information supplied in this command resides in the VSAM catalog 
and is read into storage when the ACB is opened. 
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Command Control Block (CCB) 

This information block is generated in the problem program during assembly or 
during program operation, depending on the methods of I/O control employed by 
the program. As described in Chapter 4 the CCB is generated as the first 1 6 bytes of 
a DTF when the program is using LIOCS. When using PIOCS, the CCB macro 
generates the CCB. 

The CCB establishes communication between the problem program and physical 
IOCS. The CCB is 16 bytes in length with eight major fields, and does not have to be 
aligned on a doubleword boundary. Eight optional bytes are generated if the user 
requests that a sense operation be performed on the occurrence of an I/O error. 
Data transferred from the device to real storage during a sense operation provides 
information concerning unusual conditions detected in the last operation and the 
status of the device. All data in the CCB is in the hexadecimal format. 
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CCB AND THE 
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By examining the contents of the CCB in a dump, the following information can 
be obtained about the associated I/O operation: 

• Whether the operation was completed (by inspecting the traffic bit and 
device-end bit) 

Status of the channel and device to which the I/O command was issued 
The logical unit involved in the operation 
Whether the CCB is in a real or a virtual partition 
The address of the channel program (the first CCW in a CCW string) 
The address of the next CCW to be executed, in the channel program 
(Subtracting eight from this address gives the address of the last CCW used.) 

• The residual count associated with the last CCW. 



Note: When all the following coditions have been met, bytes 9-1 1 will now be 
pointing to a non-RPS channel program in the DTF, but the one actually used 
has been released from the user's virtual save area: 

• RPS was in effect . 

• The data set has been closed . 

• The CCB was generated as the first 1 6 bytes of a DTF 
in a program using LIOCS. 

This count taken from the channel status word (CSW), is stored by PIOCS when 
the pointer to this CCB is removed from the channel queue. The residual count, in 
conjunction with the original count specified in the last CCW used, indicates the 
number of bytes transferred to or from the area designated by the CCW. When an 
input operation is terminated, the difference between the original count in the 
CCW and the residual count in the CSW is equal to the number of bytes transferred 
to storage. For an output operation, the difference is equal to the number of 
bytes transferred to the I/O device. 
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How to locate 

1. For programs using LIOCS, locate the address of the associated DTF in the 
program listing. Then use the linkage editor map to locate the DTF in the dump. 
The first 16 bytes of the DTF is the CCB. 



2. For programs using PIOCS, locate the address of the CCB macro in the program 
listing and use the linkage editor map to locate the CCB in the dump. 

3. If the interrupt code in the PSW stored in the partition save area is 00 or 07 
(SVC or SVC 7), the contents of general register 1 may contain the address of 
the CCB. To confirm whether the address in register 1 is that of a CCB, inspect 
the first few bytes starting from that address. (It is not difficult to recognize 

a valid CCB in a dump. See the example below.) 



</Xi 



12/06/73 



FP REG 
CR O-F 



000000 
000020 



BUGPRGCK 

8004008C (0004082(^ 00061000 0O00E43O 
000420C8 OA16180C 00000000 4004007* 
00000000 00000000 00000000 00000000 
004000FF OOOOE640 FFFFFFFF FFFFFFFF 
0000FFFF OOO0O0O0 00000000 OOFFFFFF 
BG AODR IS 0004AO 



00000000 00000000 00000000 00000000 
47000000 0000850E 44OC00O0 000009D2 



10.41.55 PAGE 1 

OO00E4B2 80000015 80000015 00060FFF C . s£~~ ^sj~*. J, 

0004107A 07C8C1E2 C55C5C5C 00061000 Ojf&<*trt, Ot*<^7n^ly 

00000000 OOOOOOOO 00000000 00000000 _£ / S s / 

oooooooo oooooooo oooooooo oooooooo Jo4r ^C&fbC&c&oc o&te> 

OOOOOOOO OOOOOOOO C2000000 00000200 j , 

-r-s S~ & */o e*w 

OOOOOOOO 00000*AO)40000000 oooooooo &Qr. 

OOOOOOOO OOOOOOtm 47OC2000 0000090C K {t*%7A 



040740 CE29D202 B94DC677 020BB952 CDEE0202 B95DC67B 0210B962 C09E0202 8972C67F 
040760 020CB977 CE3CD202 B983C683 5810C0AE 58F10010 45EF000C 5810CDAE 4100000B 
040780 58F1001 C8U ,6<i& Z- 1 (6nyj6x. &f) p«.»«. .»•.»«« ««"'« 

of- 040800 4110CD8 J ' 

i-^ .0*0820 IflMflESMoooi _ 

V/%7-^040840 / OOOOOOOO 00040845 /OOOOOOOO 86BCF018 
040860/ 00041019 00041019 100000050 00041338 
040880 



9/ C 
)l 

a v 



\>3is^Ei\w^&smms3sssmssssBM 



Y^PTF 



CtapeouQ . 



0320031F 004F0000J 00008000^)0OOOlO3 

V.r cc ^*<^ ::::::;:::: ccs **y 

Of 2*i>& -O/ '« Wsc& '.'.\*.'.'.\\\\ PTP --<2&m^ Oft \ 



Cam #*& tirxnAAxU) .„... x f^Up ^' CSI * / &<*£.**£&*> *frrt?;;. :::::::: xf>^ ***> e^w^&^e/ 

00008000 00000004^0040958 OOOOOOOO ..<*^«0r. .<^«< : .^°. .^ "fcx $?0 a 



040900 
040920 
040940 



Figure 4.26 The pointer and CCB in a dump 

Figure 4.27 parts 1, 2 and 3 illustrate the format and contents of the information 
contained in any CCB. 
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Count 




Transmis 
sion infor 
mation 


CSW 

Status 

Bits 


Type 
Code 


Reserved 
for 

logical 
IOCS 


CCW 
Address 


Reserved 
for 

physical 
IOCS 


CCW 
Address 
in CSW 


Optional 

Sense 

CCW 





1 


2 3 


4 5 


6 7 


8 


9 11 


12 


13 15 


16 23 
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Byte(s) 


Description 


0-1 Used for residual Count. 






2-3 Transmitting information 
between Physical IOCS 


Byte 2 


Set on by: 








& Problem Program 


Bit 0: 


Traffic Bit (Wait)/(l\lote 5) 


PIOCS* 




Bit 1: 


End of File(/* or /&); 321 1-UCSB Parity Check (Line 
Complete). (Note 2) 


PIOCS 




Bit 2: 


Irrecoverable I/O error 


PIOCS 




Bit 3: 


Accept Irrecoverable I/O error 


Pr. Pr.** 




Bit 4: 


5425 not ready, or return DASD Data Checks, 2671 
errors, 3540 Diskette Data Checks, or 101 7/1018 errors 
to the user; indicate action-type message for Video 
Display Unit 






Bit 5: 


Post at Device End (Note 5) 


Pr. Pr. 




Bit 6: 


Return Tape Read Data Check; 1018 or 2560 Data 
Check 2520, 2540, 2560, 3881 or 5425 Equipment 
Check Accept 3504, 3505 or 3525 Perm. Error, DA 
SD-Data Checks on Read or Verify Command on 321 1 
or 2245 Passback Requested. 
(Notes 3, 6 and 8) 






Bit 7: 


User Error Routine 


Pr. Pr. 


Byte 3 


Set on by: 


BitO: 


DASD-Data Check in Count Area; Permanent Error for 


PIOCS 






3330, 3340; MICR-SCU Not Operational; 1287/1288- 








Data Check; 321 1 -Print Check/Equipment Check; 








3540 Special Record Transferred. 






Bit 1: 


DASD-Track Overrun; MICR-lntervention required; 
1287-Keyboard Correction in Journal Tape Mode; 1017- 
Broken Tape; 3211 -Print Quality/Equipment Check. 


PIOCS 




Bit 2: 


DASD-End of Cylinder; MICR-(Note 4); 1287/1288- 
Hopper Empty in Document Mode. 3211/2245-Line 
Position Error. (Note 7) 






Bit 3: 


2520, 3881 -Equipment Check; 2560, 3203, 5203, 
5425 Data Check/Equipment Check; Tape-Read 
Data Check; DASD-Any Data Check 1287-Equipment 
Check; 1017/1018-Data Check; 321 1 -Print Check/Data 
Check; 3504, 3505, 3525 Perm. Error, (Note 8); 
3540 Diskette Data Check. 


PIOCS 




Bit 4: 


Non-Recovery Questionable Condition: Card-Unusual 
Command Sequence; DASD- No Record Found; 1287/ 
1288- Document Jam or Torn Tape; 321 1-UCSB Parity 
Check (Command retry); 5425 not ready 


PIOCS 




Bit 5: 


No Record Found Condition (Retry on 2311, 2314, 
2319, 3330 or 3340) 


Pr. Pr. 




Bit 6: 


Carriage Channel 9 Overflow or Verify Error for DASD; 
1287-Document Mode-Late Stacker Select; 1288-End of 
Page. 


PIOCS 




Bit 7: 


Command Chaining, Retry from the next CCW to be 
executed 


Pr. Pr 



*Physical IOCS **Problem Program 

Figure 4.27 Explanation of the contents of the CCB, part 1 of 3 
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Count 


Transmis- 
sion infor- 
mation 


CSW 

Status 

Bits 


Type 
Code 


Reserved 
for 

logical 
IOCS 


CCW 
Address 


Reserved 
for 

physical 
IOCS 


CCW 
Address 
in CSW 


Optional 

Sense 

CCW 


1 


2 3 


4 5 


6 7 


8 


9 11 


12 


13 15 


16 23 



Byte(s) 



4-5 CSW Status Bits 



6-7 Type Code 



Description 



Byte 4 (Note 1) 



Bit 0(32) Attention 

1 (33) Status Modifier 
2(34) Control Unit End 
3(35) Busy 
4(36) Channel End 
5(37) Device End 
6(38) Unit Check 
7(39) Unit Exception 



Byte 5 



Bit 0(40) Program Controlled 
Interruption 
1 (41) Incorrect Length 
2(42) Program Check 
3(43) Protection Check 
4(44) Channel Data Check 
5(45) Channel Control Check 
6(46) Interf. Control Check 
7(47) Chaining Check 



Byte 6 



X'Ou' Original CCB (Bytes 9-11 and 13-15 contain virtual addresses 
X'2u' Translated CCB (Byte 9-1 1 contain real address, bytes 1 3-1 1 

virtual address) 
X'4u' BTAM request original CCB (Bytes 9-1 1 and 1 3-1 5 contain 

virtual addresses) 
X'6u' BTAM request translated CCB (Bytes 9-1 1 contain real address, 

bytes 13-1 5 virtual address) 
X'8u' User-translated CCB in virtual partition (Bytes 9-1 1 and 1 3-1 5 

contain real addresses) 

Note: Any one of the above incremented by X'10' (bit 3 on) indicates 
automatic switching to the beginning of the next cylinder at 
End of Cylinder condition, 
u: 0= The address in byte 7 refers to a System Logical Unit. 

1= The address in byte 7 refers to a Programmer Logical Unit. 



Byte 7 



Hexadecimal representation of SYSnnn: 



SYSRDR 


= 00 


SYSIPT 


= 01 


SYSPCH 


= 02 


SYSLST 


= 03 


SYSLOG 


= 04 


SYSLNK 


= 05 


SYSRES 


= 06 


SYSSLB 


= 07 


SYSRLB 


= 08 


SYSUSE 


= 09 



SYSREC 


= 0A 


SYSCLB 


= 0B 


SYSVIS 


= OC 


SYSCAT 


= OD 


SYS000 


= 00 


SYS001 


= 01 


SYS002 


= 02 


SYSnnn 




(Note 9) 





<f 



J 



Figure 4.27. Explanation of the contents of the CCB, part 2 of 3 
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Count 


Transmis- 
sion infor- 
mation 


CSW 

Status 

Bits 




Type 
Code 




Reserved 
for 

logical 
IOCS 


CCW 
Address 


Reserved 
for 

physical 
IOCS 


CCW 
Address 
in CSW 


Optional 

Sense 

CCW 


1 


2 3 


4 


5 6 


7 


8 


9 11 


12 


13 15 


16 23 






Byte(s) 


Description 


8 Reserved for 
Logical IOCS 


Buffer Offset 

ASCII Input Tapes X'00'-X'63' 

ASCII Output Tapes Fixed X'OO' 
Variable X'OO' or X'04' 
Undefined X'OO' 


9-1 1 CCW Address 


Virtual or real address of CCW associated with this CCB depending 
on byte 6: 

Real address if byte 6= X'2u', X'6u\ or X'8u'; 
Virtual address if byte 6= X'Ou', or X'4u'. 


12 Reserved for 
Physical IOCS 


X'80' CCB being used by ERP 

X'40' Channel Appendage Routine present for TP device, VSAM 

or POWER 
X'20' Sense Information desired 
X'10' Message writer 
X'08' EU Tape Error 
X'04' OLTEP Appendage available 
X'02' Tape ERP Read Opposite Recovery 
X'01' Seek Separation 


1 3-1 5 CCW Address 
* in CSW 


Virtual Address of CCW pointed to by CSW at Channel End 
(if byte 6= X'8u', it is the real address) or address of the 
Channel End Appendage Routine for TP devices, 
VSAM or POWER. 


16-23 Optional 

Sense CCW 


8 bytes appended to the CCB when Sense Information is 
desired. 



t3 



Note 1 : Bytes 4 and 5 contain the status bytes of the Channel Status Word (Bits 32-47). 
If byte 2, bit 5 is on and device end results as a separate interrupt, device end 
will be OR-ed into CCB byte 4. 

Note 2: Indicates /* or/& statement on SYSRDR or SYSIPT. 
Byte 4, bit 7 (unit exception) is also on. 

Note 3: DASD data checks on count not returned. 

Note 4: For 1255/1259/1270/1275/1419, disengage. For 1275/1 41 9D, I/O Error is 
external interrupt routine (Channel data check or bus-out check). 

Note 5: The traffic bit (Byte 2, bit 0) is normally set on at channel end to signify that the 
I/O was completed. If byte 2, bit 5 has been set on, the traffic bit and bits 2 and 6 
in byte 3 will be set on at device end. Also see Note 1 . 

Note 6: 1018 ERP does not support the Error Correction Function. 

Note 7: This error occurs as an equipment check, data check or FCB parity check. 
For 2245, this error occurs as a data check or FCB parity check. 

Note 8: For 3504, 3505, 3525 input or output files using ERROPT, byte 3-bit 3 is set on if a 
permanent error occurs. Byte 2-bit 6 is set on to allow you to accept permanent errors. 

Note 9: SYSnnn= 255-(Number of partitions x 14). 

Figure 4.27. Explanation of the contents of the CCB, part 3 of 3. 
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The channel program 

A channel program consists of one or more CCWs (channel command words). The 
channel program is generated during assembly or during program operation, 
depending on the method of I/O control employed by the program. A CCW specifies 
the command, the storage area to be used for the I/O operation, and the action to 
be followed when the operation is completed. When a program is running in a 
virtual partition, the CCWs are copied into the real address area. 

Translation from the virtual I/O area addresses in the CCW to real addresses is 
accomplished either by the supervisor channel program translation routines. 

The contents of CCWs should be inspected when the cause of a system malfunction 
leads you to suspect I/O operation errors. For example, parts of a program being 
overwritten and causing invalid instructions, or unexpected information in your 
program I/O data area will probably cause a program check and generate incorrect 
output from your program. 

By examining the contents of the channel program the following information can 
be obtained: 

• Validity of the operation code and of the sequence of CCWs used. If either of 
these is invalid, an informatory message is normally printed on SYSLOG to 
help you to determine the cause of the error. 

(Consult the component manual for the I/O device for the valid codes and 
sequence of use.) 

• Data address in the last CCW used. Translated channel programs are 
destroyed in a system dump by the channel programs required for the DUMP 
and by channel programs started for other partitions. However, they can be 
located in a stand-alone dump, an example of which is shown in Appendix G. 
(Refer to chapter 12 in this section for methods of translating real addresses 
to virtual and vice-versa.) 

• Count in the CCW. This must be a byte count of one or more for any I/O 
operation not involving magnetic tape units. (For a transfer in channel (TIC) 
command, the count may be zero.) 

• When working with wrong length records or variable length records, the 
suppress length indicator should be set to 1 to prevent an error condition. 









y 
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How to locate: 



Bits 8-31 of the CSW (Channel Status Word) stored in location X'40' of low 

address storage contain the address of the next CCW to be executed. Subtract 

eight from this address to obtain the address of the last CCW used. (Refer to 

Section 2-E-2 for details of low address storage.) 

Caution: The data stored in low address storage may be overwritten by the 

dump program. If this is thought to be the case, use the method described 

below. 

Bytes 9-11 of the CCB associated with the channel program contain the 

addresses of the first CCW in the channel program. Bytes 13-15 of the same 

CCB contain the address of the next CCW. Subtract eight from this address 

to obtain the address of the last CCW used. 

The figure below shows the format and contents of any CCW. 
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CCB AND THE 
CHANNEL PROGRAM 



Command 


Data Address 


Flags 


00 


TP code 


Count 



32 



38 



40 



48 



63 






FIELD 


DESCRIPTION 


Command 
Code 


Bits 0-7: 

Specify the operation to be performed. 
Consult device component manual 


Data Address 


Bits 8-31: 

Specify the location of a byte in main storage. It is the first location 
referred to in the area designated by the CCW. 


Flags 


Bits 32-36: 

Specify the flag bits used in conjunction with the CCW. 

Bit 32- 

Chain-Data (CD) causes the address portion of the next CCW to be 
used with the current CCW. 

Bit 33- 

Chain-Command (CO causes the command code and data address 
of the next CCW to be used. The chain data flag (bit 32) takes 
precedence over this flag. 

Bit 34- 

Suppress Length Indication (SLI) causes a possible incorrect length 
indication to be suppressed. The chain data flag (bit 32) takes 
precedence over this flag. 

Bit 35- 

Skip (SKIP) suppresses the transfer of information to real storage. 

Bit 36- 

Program Control Interruption (PCI) causes the channel to generate 

an interrupt when the CCW is fetched. 
Bit 37- 

IDAL bit. Set to 1 if I/O area crosses page boundary, that is, if the 

I/O area is not confined to one page frame in real storage. 


Reserved 


Bits 38-39: 

(Must contain zeros)* 


TP 


Bits 40-47: 


Count 


Bits 48-63: 

Specify the number of bytes in the operation 



%J 



*The transfer in channel command (TIC) is the one exception to this statement. 
Figure 4.28. Explanation of contents of the CCW 
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SUPERVISOR CALLS A problem program running in any partition fields control to the supervisor by 

issuing a supervisor call instruction. The SVC instruction contains a code that 
indicates its purpose. For example, SVC requests the supervisor to execute the 
channel program. Some SVCs are optional and cause program cancellation if the 
supervisor does not support the option requested. 

A complete list of DOS/VS SVC codes with the associated macro instructions that 
generate the SVC is shown in Figure 4.29 parts 1, 2 and 3. 

A detailed description of the SVCs can be found in DOS/VS Supervisor Logic. 
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SVC 
Dec Hex 


Macro supported 


Function 








EXCP 


Execute Channel Program 


1 


1 


FETCH 


Fetch any phase 


2 


2 




Fetch a logical transient (B-transient) 


3 


3 




Force dequeue 


4 


4 


LOAD 


Load any phase 


5 


5 


MVCOM 


Modify supervisor communication region (if issued by 
MVCOM macro) Fetch any other physical transient (if 
issued by a physical transient) 


6 


6 


CANCEL 


Cancel a problem program or task 


7 


7 


WAIT 


Wait for a CCB or TECB 


8 


8 




Transfer control to the problem program from a logical 
transient (B-transient) 


9 


9 


LBRET 


Return to a logical transient (B-transient) from the 
problem program after an SVC 8 


10* 


A 


SETIME 


Set timer interval 


11 


B 




Return from a logical transient (B-transient) 


12 


C 




Reset switches in partition communication region. 


13 


D 




Set switches in partition communication region. 


14 


E 


EOJ 


Cancel job and go to job control for end of job step 


15 


F 


SYSIO 


Headqueue and execute channel program 


16* 


10 


STXIT(PC) 


Provide supervisor with linkage to user's PC routine 
for program check interrupts 


17* 


11 


EXIT(PC) 


Return from user's PC routine 


18* 


12 


STXIT(IT) 


Provide supervisor with linkage to user's IT routine 
for interval timer interrupts 


19* 


13 


EXIT(IT) 


Return from user's IT routine 


20* 


14 


STXIT(OC) 


Provide supervisor with linkage to user's OC routine for 
external or attention interrupts (operator comm.) 


21* 


15 


EXIT(OC) 


Return from user's OC routine 


22 


16 


SEIZE 


Seize/release system; enable/disable for external and 
I/O interrupts; set key in users PSW 


23* 


17 




Load phase header. Phase load address is stored at 
user's address 


24* 


18 


SETIME 


Set timer interval and provide supervisor with linkage 








to user's TECB, if any 


25* 


19 




Issue HALT I/O on a teleprocessing device, or HALT I/O 
on any device if issued by OLTEP. With multiprogramming 
dequeue an unstarted OLTEP I/O request to a shared 
device 


26* 


1/s 




Validate address limits 


27* 


1B 




Special HIO on teleprocessing devices 


28* 


1C 


EXIT(MR) 


Return from user's stacker select routine (MICR type 
devices only) 


29* 


1D 


WAITM 


Provide support for multiple wait macro WAITM 


30* 


1E 


QWAIT 


Wait for a QTAM element 


31* 


1F 


QPOST 


Post a QTAM element 

■ 
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SUPERVISOR CALLS 



optional 



Figure 4.29 Supervisor Calls (Part 1 of 3) 
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SUPERVISOR CALLS 



SVC 
Dec 


Hex 


Macro Supported 


Function 


32 


20 




Reserved 


33 


21 




Reserved for COMRG macro 


34 


22 


GETIME 


Provides Time-of-Day and updates the DATE field 


35* 


23 


HOLD 


Hold a track for use by the requesting task only 


36* 


24 


FREE 


Free a track held by the task issuing the FREE 


37* 


25 


STXIT(AB) 


Provide supervisor with linkage to user's AB routine for 
abnormal termination of a task 


38* 


26 


ATTACH 


Initialize a subtask and establish its priority 


39* 


27 


DETACH 


Perform normal termination of a subtask. It includes 
calling the FREE routine to free any tracks held by the 
subtask 


40* 


28 


POST 


Inform the system of the termination of an event and 
ready any waiting tasks 


41* 


29 


DEQ 


Inform the system that a previously enqueued resource is 
now available 


42 


2A 


ENQ 


Prevent tasks from simultaneous manipulation of a shared 
data area (resource) 


43 


2B 




SDR SVC 


44* 


2C 




Provide supervisor support for external creation of unit 
check records by specific request 


45* 


2D 




Provide emulator interface 


46* 


2E 




Provide OLTEP with the facility to operate in supervisory 
state 


47* 


2F 


WAITF 


Provide support for multiple wait macro for MICR type 
devices 


48* 


30 




Fetch a CRT transient 


49 


31 




Reserved 


J50 


32 




Reserved for LIOCS error recovery 


!51 


33 




Return phase header 


52* 
53 


34 
35 


TTIMER 


Return the remaining time interval, or cancel a time 

interval 

Reserved 


54 


36 


FREEREAL 




55 

56* 


37 
38 


GETREAL 


Provide interf. between SDAID and PDAID initialization 
routine and page management routine, to create the 
PDAID alternate area of the SD area 
Reserved 


57* 


39 




Reserved 


58 


3A 




[Provide interface between job control and the supervisor. 
Get real storage for real jobs 



optional 






Figure 4.29 Supervisor Calls (Part 2 of 3) 
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SUPERVISOR CALLS 



C 



SVC 
Dec Hex 


Macro supported 


Function 


59 


3B 




Provide interface between EOJ and the supervisor. Reset 
the storage key for virtual jobs 


60 


3C 


GETADR 


Provide virtual address of location within I/O areas for 
ERP and CRT routines 


61* 


3D 


GETVIS 


Get storage in virtual partition 


62* 


3E 


FREEVIS 


Free storage in virtual partition 


63 


3F 


USE 


Use a resource 


64 


40 


RELEASE 


Release a resource 


65 * 


41 


CDLOAD 


Load VSAM or core image phase 


66 


42 


RUNMODE 


Return mode in which program is running 


67 * 


43 


PFIX 


Fix page(s) in real storage 


68* 


44 


PFREE 


Free page(s) in real storage 


69* 


45 


REALAD 


Return real address corresponding to a given virtual 
address 


70* 


46 


VIRTAD 


Return virtual address corresponding to a given real 
address 


71 • 


47 


SETPFA 


Establish or terminate the linkage between the supervisor 
and a user page-fault appendage routine 


72 • 


48 


GETCBUF- 
FREECBUF 


Get or free copy buffer for IDAL or tape ERP 


73* 


49 


SETAPP 


Allow linkage to channel and appendage routines 


74* 


4A 




Fix page(s) in real storage for restart 


75 


4B 




SECTVAL Calculate value of sector for RPS 


76 


4C 




Initiate RMS recording of an I/O error 


77 


4D 


TRANSCSW 


Returns the virtual address of a copied CCW 


78 thru 84 




Reserved 


85 


55 


RELPAG 


Release contents of one or more pages 


86 


56 


FCEPGOUT 


Force a page-out for one or more pages 


87 


57 


PAGEIN 


Page in one or more pages 


90 


5A 


PUTACCT 


Provide interface with POWER/VS for additional 
account information (by user). 


91 


5B 




Provide interface with POWER/VS for standard 
account information (DOS/VS). 



* optional 
Figure 4.29 



Supervisor Calls (Part 3 of 3) 
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The PIB (program Information Block) 

Real storage area is reserved in the supervisor for this information block by the 
MPS multiprogramming and/ or NPARTS and AP (Asynchronous Processing) 
parameters of the SUPVR supervisor generation macro. Each entry in this block is 
16 bytes and contains status information about the program and, if AP is supported 
about the subtasks running in each partition supported by the supervisor. 

The first entry is reserved for the attention routine, this entry is called the 
Attention PIB (AR PIB). 

Other entries in the PIB belong to the problem programs and subtasks. The sum of 
all subtasks and problem program entries may not exceed 15. The maximum number 
of entries, including the attention PIB and AP (subtask) PIBs, is 16. 

For a supervisor that is not generated to support more than one partition there is 
only one 16-byte entry, which is shared by the attention routine and the 
problem program. 

By examining the data recorded in the appropriate PIB entry, the status and 
location of programs running in any partition can be established. Some of the 
more important data to be looked at in the PIB during the first analysis of a dump 
output are: 

• Byte 0, from which you can determine whether the program is waiting for 

• The LTA (Logical Transient Area), X'8 1' 

• The PTA (Physical Transient Area), X'85' 

• An I/O interrupt, X'82' 

• A page to be paged in, X'87' 

• A page to be paged in with QTAM active, X'8F' 

• Byte 4, X'80', which indicates that the job or task is running in virtual mode 

• The address of the program save area 

• The address of the system save area. 

Figure 4.30 (opposite) shows the format and describes the contents of an entry 
in the PIB. 



iv 



How to locate: 

Bytes X'5A' — X'5B' of the partition comregs contain the address of the first entry 
in this information block. Label PIBTAB in the supervisor listing identifies the 
address of the first byte of this information block. 

Appendix G shows an example of locating the PIB in a dump output. 
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PIBTAB 



Attention 


PIB 


Backgroun 


d PIB 


FG4 


PIB 


FG3 


PIB 


FG2 


PIB 


FG1 


PIB 


Subtask 


PIB 








Subtask 


PIB 




Format of 
Attention PIB 
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PIB ANDPIB2 





#%, 






1 


2 3 


4 


5 6 7 


8 


9 10 11 


12 


13 


14 


15 




Flag 
Byte 


Cancel 


SYSLOG 


always 


Inactive = zero 


Switch 


Address of save 


X'07' 


BG 


Number 


Not 




Code 


ID 
(AR) 


zero 


Active = Address 
of LTA save area 


Byte 


area of zero 


PIB 
assign 


user 
LUB 


of BG 
pro- 


used 




(See A ) 








(Note 2) 


(See F ) 


(Note 1) 
(Note 2) 


flag 
(See D) 


index 


gram 
LUB's 







Note 1: a) When L TA is inactive= L TA save area address. 

b) When L TA is active for Problem Programs, this address is exchanged with that in the Problem Program PIB. 



Note: 



When L TA is active for Logical Attention, bytes 9-11 are zero and bytes 5- 7 contain the L TA save area address. 




Format of any 
Probl. Program 
or Subtask PIB 



Legend: A, B, C, D, E, F refer to next 
part of this figure, which 
describes the meaning of each 
bit in a PIB entry 






1 


2 3 


4 


5 6 7 


8 


9 10 11 


12 


13 


14 


15 




Flag 


Cancel 


SYSLOG 


DAT 


Address of Problem 


Gate 


Address of sys- 


PIB 


User 


Number 


Flag 




Byte 


Code 


ID 


flag 


Program save area or 
LTA save area 


ID 


tem save area 


assign 
flag 


LUB 
index 


of 
Pro- 
gram 


Byte 




(See A ) 






(See B ) 


(Note 3) 


(See C ) 




(See D) 




LUB's 


(See E ) 





Note 3: When the Logical Transient Area is active the save area address in the Problem Program PIB is exchanged with that in the 
Attention PIB. 

The number of Problem Program PIBs generated depends on the number of partitions specified during system generation. 
Subtask PI Bs are generated only if AP= YES has been specified during system generation. 
The number of subtask PIBs generated depends on the number of partitions, that is: 



Figure 4.30 Explanation of the contents of an entry in the PIB, 
part 1 of 3. 



No. of partitions 



No. of subtasks 



13 
12 
11 
10 



Debugging for Programmers, part 2. 4.89 



Section 4, Chapter 7 

PIBAND PIB2 



Flag Byte (First byte in PIB) 

The following flags are always used: 

X'71' = Program is waiting for SVC58 

X'73' = Program is waiting because system is seized 

X'75' = Program is waiting for copy block 

X'77' = Program is waiting for TFREE 

X'79' = Program is waiting for channel queue entry 

X'7B' = Program is waiting for CCW translation 

X'7D'= Program is waiting for a free Console Buffer 

X'80' = Program is not active 

X'8T = Program is SVC2-bound (waiting for the LTA to be released) 

X'82' = Program is SVC7-bound (waiting for an I/O interruption) 

X'83' = Program is ready to run 

X'85' = Program is SVC5-bound (waiting for the PTA to be released) 

X'86' = Initial selection of RAS (used only for RAS PIB flag) 

X'87' = Program is set to common bound condition 

The following flags are used only if NPARTS = 1. X'6T through X'69'are used 
by the load leveller to deactivate a partition. The partition to which a flag 
refers depends on NPARTS as follows: 









NPARTS - 








2 


3 


4 


5 


X'61' 


refers to 


BG 


BG 


BG 


BG 


X'63' 


refers to 


F1 


F2 


F3 


F4 


X'65' 


refers to 


- 


F1 


F2 


F3 


X'67' 


refers to 


- 


— 


F1 


F2 


X'69' 


refers to 


— 


— 


— 


F1 



X'6B' = Program is SVC35-bound 

X'6D'= Program is waiting for next freed page frame 

X'6F' = Program is IDRA-bound 

The following flags are only used if AP= YES: 

X'51' = Program is SVC38-bound 
X'53' = Program is SVC41 /42-bound 

The following codes are only used if AP= YES and PFIX= YES. 

The codes are used by the PFIX routines to set a partition PFIX bound. 

The partition to which a flag refers depends on NPARTS as follows: 



G 









NPA 


RTS = 








2 


3 


4 


5 


X'47' 


refers to 


BG 


BG 


BG 


BG 


X'49' 


refers to 


F1 


F2 


F3 


F4 


X'4B' 


refers to 


- 


F1 


F2 


F3 


X'4D' 


refers to 


- 


- 


F1 


F2 


X'4F' 


refers to 


- 


— 


— 


F1 



The following codes are used only if AP= YES and VSAM= YES. 

The codes are used by the VSAM routines to set a partition PFIX bound. 

The partition to which a flag refers depends on NPARTS as follows: 

NPARTS = 



X'3D' refers to 
X'3F' refers to 
X'41 ' refers to 
X'43' refers to 
X'45' refers to 



BG 
F1 



BG 
F2 
F1 



4 

BG 
F3 
F2 
F1 



BG 
F4 
F3 
F2 

F1 



Figure 4.30 Explanation of the contents of an entry in the PIB, part 2 of 3. 



jj 
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B PIB DAT Flag 

X'01' = Return to re-entrant supervisor routine 

X'02' = Return to gated supervisor routine 

X'04' = Move CCB at dispatching time 

X'08' = Service delayed external interrupt 

X'10' = Task is temporarily deactivated 

X'20' = Reserved 

X'40' = Task has seized the system 

X'80' = Program is running in virtual mode 

C Gate Identifier 



X'71 ' = Gating of SVC58 required 
X'53' = Gating of SVC41 /42 required 

The flags are only used if the PIB DAT Flag is X'03', that is, the first two 
flags are on (See B ). 

D PIB Assign Flag 

X'80' = SYSRES DASD file protect inhibited (allow write operation on SYSRES) 

X'40' = Channel appendage exit allowed (BTAM) 

X'20' = Cancel in progress (used in terminator function) 

X'10' = Cancel control (set on a foreground cancel) 

X'08' = Hold foreground assignments 

X'07' = Attention PIB 

E Problem Program PIB Flag (Last byte in PIB) 



1= Batched job in foreground (always on when tested) 
1= Cancel in LTA and device not assigned 
1=/&on SYSIN if DASD 
1= Partition in stopped state 
1= Fetch EOJ monitor 
1= Task is canceled 
1= Subtask(s) attached 
1= in AB routine 



Attention PIB Switch Byte 



Reserved 

Reserved 

1= Delay cancelation 

1= Emergency cancel request 

1= Detach Logical Attention Routine (SSBATTNA) 

Reserved 

1= Fetch Logical Attention Routine (SSBATTNA) 

1 = External Interrupt request 
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Figure 4.30. Explanation of the contents of an entry in the PIB, part 3 of 3 
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PIB AND PIB2 PIB2 (Program Information Block Extension) 



As the name of this block implies, it is an extension of the PIB and is of identical 
size, being generated with the PIB during system generation. Data recorded in each 
16-bytes entry supplements the data recorded in the PIB. 

By examining the contents of bytes and 1 of the appropriate problem program 
PIB2 entry, the address of the associated partition communication region can be 
established. 



How to locate: 

Bytes X'7C - X'7D' of the partition comregs contain the address of the first entry 
in this information block. Label PIB2TAB in the supervisor listing identifies the 
address of the first byte of this information block. 

Appendix G shows an example of locating the PIB2 in a dump. 
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PIB2TAB 



Attention 


PIB 


Backgroun 


d PIB 


FG4 


PIB 


FG3 


PIB 


FG2 


PIB 


FG1 


PIB 


Subtask 


PIB 


===== 


Subtask 


PIB 



Format of any 
PIB extension 
entry 
1 2 



3 4 



7 8 



10 



11 12 



13 14 



15 



1 6-bit 














Address of com- 


System 


Interrupt 


Address of termination ECB 


Program 


un- 


Flag 


munication 


LUB index 


Information 


if any, otherwise zeros 


Interrupt 


used 


Byte 


region of 








Key (PIK) 




(See 


partition 












B 


(Note 1 ) 




(See table A below) 








below) 



Note 1: Always BG communication region in Attention— and Background PIB extension. Appropriate communication region in other 

PIB extensions when a multiprogram system has been generated. To place this address in a register, the instruction ICM should 

be used. 

For each PIB Table entry, an entry exists in the PIB Table Extension. 



Type of interruption 


Contents of PIB Extension Bytes 


4 


5 


6 | 7 


SVC 
PC 

I/O 


00 
00 
00 


ILC* 
ILC* 
00 


Interruption Code 
Interruption Code 
I/O Address 



Byte 14 



Not used 



Byte 1 5 



Bit 1 : Not used 
Bit 2: 1 =Task owns CRT 
3-7: Not used 



ILC (Instruction Length Code) is in bits 5 and 6; other bits are zeros. 



Figure 4.31. Explanation of the contents of an entry in the PIB2 
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CANCEL CODES 



Byte 1 of the PIB contains a cancel code that is stored by the supervisor in the 
event of program cancellation. Normally a message is printed on SYSLOG and/or 
SYSLST that informs the operator about the reason for the cancellation, for 
example: 



/f~\ 



BG 0S04I ILLEGAL SVC - HEX LOCATION 007884 



SVC CODE 14 



The cancel code (stored in byte 1 of the associated partition PIB) should be 
examined also in the event of a system malfunction such as a LOOP or WAIT STATE 
that prevents the system from issuing an error message. 

Figure 4.32 (below) shows a list of all the cancel codes and their message prefixes. 

All these cancel codes cancel the program, task, or subtask when they occur. If 
multitasking is being used and a main task is canceled, all of the subtasks attached 
are detached and canceled as a result of the main task being canceled. If a dump 
option was specified at system generation time or by job control, the contents of 
the supervisor and the partition in which the cancel condition occurred is printed 
on SYSLST. 



Cancel 
Code (hex) 


Message 
Code 


Descriptive part of Message 
or Condition 


10 




Normal EOJ 


11 


0V07I 


No channel program translation for unsupported device 


12 


0V06I 


Insufficient buffer space for channel program translation 


13 


0V05I 


CCW with count greater than 32 K 


14 


0V04I 


Page pool too small 


15 


0V02I 


Page fault in disabled program 


16 


0V01I 


Page fault in MICR stacker select or PHO routine 


17 


0S02I 


Program request (Same as 23 but causes dump because subtasks 
were attached when maintask issued CANCEL macro) 


18 




Eliminates cancel message when maintask issues DUMP macro 
with subtasks attached 


19 


0P74I 


I/O operator option 


1A 


0P73I 


I/O error 


1B 


0P82I 


Channel failure 


1C 


0S14I 


CANCEL ALL macro 


1D 


0S12I 


Main task termination 


1E 


0S13I 


Unknown ENQ requestor 



Figure 4.32. DOS/VS Cancel Codes and Messages, part 1 of 2. 
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Cancel 


Message 


Descriptive part of Message 


Code (hex) 


Code 


or Condition 


1F 


0P81I 


CPU failure 


20 


0S03I or 
0S11I 


Program check 


21 


0S04I or 
0S09I 


Illegal SVC 


22 


0S05I or 
0S06I 


Phase not found 


23 


0S02I 


Program request 


24 


0S01I 


Operator intervention 


25 


0P77I 


Invalid address 


26* 


0P71I 


SYSxxx not assigned (unassigned LUB code) 


27 


0P70I 


Undefined logical unit 


28 




QTAM cancel in progress 


29 


0S15I 


No relocating loader support (Fetch or load request for 
relocatable phase while supervisor does not support relocating 
load) 


2A 


0P84I 


I/O error during fetch (irrecoverable I/O error during fetch 


2B 


0V10I 


I/O error on page data set 


2C 


0V09I 


Illegal parameter passed by PHO routine 


2D 


0P88I 


Program cannot be executed/restarted due to failing storage block 


2E 


0S16I 


Invalid resource request (possible deadlock) 


2F 


0V03I 


More than 255 PFIX requests for 1 page 


30 


0P721 


Reading past /& statement (on SYSRDR or SYSIPT) 


31 


0P75I 


I/O error queue overflow (error queue over-flow) 


32 


0P76I 


Invalid DASD address 


33 


0P79I 


No long seek (disk) 


34 




Reserved 


35 


0P85I 


Job control open failure 


36 


0V08I 


Page fault in I/O appendage routine 


37 




Reserved 


38 


0V11I 


Wrong privately translated CCW 


39 




Reserved 


FF 


0P78I 


Unrecognized cancel code 




0P83A** 


Supervisor catalog failure 




0P87A** 


IPL failure 
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Figure 4.32. DOS/VS Cancel Codes and Messages, part 2 of 2. 

* If the CCB is not available, the logical unit is SYSxxx. 

** The cancel code is not significant in case of a supervisor catalog or IPL failure, because 
the system is placed in the wait state without any further processing by the Terminator. 

Note: In addition to recognizing the cancel codes above, the Terminator also recognizes the 
same codes with the X'80' bit on (cancel occurred in L TA). The X'80' bit is tested by 
$$BEOJ and subsequently reset. 
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The following paragraphs describe the general usage of registers 0, 1, 13, 14, and 15 
by IOCS, but the description is not meant to be all-inclusive. 

Registers and 1: Logical IOCS macros, the supervisor macros, and other IBM- 
supplied macros use these registers to pass parameters. Therefore, these registers 
may be used without restriction only for immediate computations, where the 
contents of the register are no longer needed after the computation. If you use them, 
however, you must either save their contents yourself (and reload them later) or 
finish with them before IOCS uses these registers. 

Register 13: Control program subroutines, including logical IOCS, use this register 
as a pointer to a 72-byte doubleword-aligned save area. When using the CALL, 
SAVE, or RETURN macros, you can set the address of the save area at the beginning 
of each program phase, and leave it unchanged thereafter. However, when sharing 
a reenterable (read only) logic module among tasks, each time that module is 
entered by another task, register 13 must contain the address of another 72-byte 
save area to be used by that logic module. 

Registers 14 and 15: Logical IOCS uses these two registers for linkage. Register 14 
contains the return address (to the program) from DTF routines, called programs, 
and your subroutines. Register 15 contains the entry point into these routines, and 
is used as a base register by the OPEN (R), CLOSE (R), and certain DTF macros. 
IOCS does not save the contents of these registers before using them. If you use 
these registers you either save their contents yourself (and reload them later) or 
finish with them before IOCS uses them. 



Registers for Your Use 

Registers 2-12 are available for general usage. There are, however, a few restrictions. 

The assembler instruction for translate and test (TRT) makes special use of 
register 2. It is your responsibility to save the contents of this register before 
executing the TRT instruction if register 2 contains valuable information (such as 
pointers or counters) for later use in your program. After the TRT instruction has 
been executed, you can then restore the contents of register 2 from the save area. 

If an ISMOD logic module precedes a USING statement or follows your program, 
the use of registers 2-12 remains unrestricted even at assembly time. However, if 
the ISMOD logic module lies within the problem program, you should issue the 
same USING statement (which was issued before the logic module) directly follow- 
ing the logic module. This action is necessary because the ISMOD logic module 
uses registers 1 , 2, and 3 as base registers, and the ISMOD CORDATA logic module 
uses registers 1, 2, 3, and 5 as base registers. Each time either module is assembled, 
these registers are dropped. 



~~>- 
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Register usage by JOB ACCOUNTING GENERAL PURPOSE 

\ REGISTER USAGE 

(The Job Accounting option is discussed in Chapter 13 of this Section) 

The system passes registers 1 1-15 to the user's I/O routine ($JOBACCT). These 
registers contain the following information: 

• Register 1 1 : Length of the job accounting table. Each table may vary in 
length according to the number of SIO counts specified at system generation 
time. 

• Register 12: Base register for $JOBACCT (this eliminates the need for the 
user to load the base register) 

• Register 13: Address of the user save area 

• Register 14: Link register ($JOBACCT must exit via BR 14 to return to 
job control) 

• Register 15: Address of the partition's job accounting table. 
Because some of the job step information is cleared in the step-to-step transition, 
job control calls $JOBACCT at the end of each step. If $JOBACCT does not save 
or accumulate this information, it is lost. 



o 
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Linkage Registers 

To standardize branching and linking, registers are assigned specific roles (Figure 
4.33). Registers 0, 1, 13, 14, and 15, are known as the linkage registers. Before a 
branch to another routine, the calling program is responsible for the following 
calling sequence: 

1. Loading register 13 with the address of a register save area in the program 
that the called program is to use 

2. Loading register 14 with the address to which the called program will return 
control 

3. Loading register 15 with the address from which the called program will 
take control 

4. Loading registers and 1 with parameters, or loading register 1 with the 
address of a parameter list. (Although permissible, it is not normal to load 
register with parameters). 






Register 
Number 


Register Name 


Contents 





Parameter register 


Parameters to be passed to the called 
program. 


1 


Parameter register 

or 

Parameter list 
register 


Parameters to be passed to the called 
program. 

Address of a parameter list to be 
passed to either the control program 
or a user's subprogram. 


13 


Save area register 


Address of the register save area to be 
used by the called program. 


14 


Return register 


Address of the location in the calling 
program to which control should be 
returned after execution of the 
called program. 


15 


Entry point register 


Address of the entry point in the 
called program. 



vV 



Figure 4.33 Linkage Registers 

After execution of the calling sequence, the following should occur as a result of 
called program execution: 

1. The contents of registers 2 through 14, and the program mask are unchanged. 

2. The contents of registers 0, 1 and 15, the contents of the floating point 
registers, and the condition mode may be changed. 

3. The parameter list addresses contain the results obtained by the execution 
of the called program. 
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When support is provided during system generation for user exit routines (other TAB LES R EQU I R ED B Y 

than VSAM exit routines), an area is reserved in the supervisor for one or more of USER EXIT ROUTINES 

the following tables: 

• Interval timer (IT") 

• Abnormal termination (AB) 

• Page fault handling overlap (PHO) 

• Program check (PC) 

• Operator communication (OC). 

Entries in the table are generated from the STXIT macro issued by the problem 
program, and the number of entries depends on the number of partitions for 
which the system has been generated. 

The number of entries for the PC and AB tables is increased by the number of 
subtasks allowed on a system generated for use with multitasking. 
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TABLES REQUIRED BY 
USER EXIT ROUTINES 



Interval Timer Support (IT) 

This parameter generates programming support for the hardware interval timer 
feature, which is used to time-stamp the system. It enables a problem program to 
set a time interval (via the SETIME macro). 

By using the STXIT, EXIT, and TECB macros, a specific routine within the problem 
program or task is entered when this time interval elapses. 

How to locate the IT option table 

Bytes X'66'-X'67' of the partition communication regions contain the address of 
the IT Option Table. Label ITTAB identifies the first byte of the table. 



ITTAB 



See 
Note 



v 



BG 



F4 



F2 



F1 



Subtask 



Subtask 



Subtask 



34 



TECB 



Save Area 



/ 



Address 

i 



Compl. of TECB, 
Save Area , 



■Address 



/ 



\ 



/ 



\ 



/ 



\ 



/ 



/ 



\ 



/ 



\ 



\ 



/ 






\ 


Bytes 0-3: 


No TECB or STXIT 








issued 


zero 






TECB issued 


Address of the timer event control block 






STXIT issued 


Address of user interval timer routine 






STXIT issued and 








user routine is 








already in use 


Complement of the user interval timer routine 




Bytes 4-7: 


No TECB or STXIT 








issued : 


zero 






TECB issued 


Complement of the TECB address 






STXIT issued 


Address of the user save area 





4~ 



Note: One table entry is built for each partition and an IT Request table is also built. 

With multiple timer and asynchronous processing supported, the table always 
comprises 15 entries; the subtask entries occupy the higher address locations 
in the table. 

Figure 4.34. Explanation of the contents of the IT option table. 



o 



4.100 ' Debugging for Programmers, part 2. 



Interval Timer Request Table 

This table is generated only for systems supporting the interval timer option 
(IT= YES). It is used in conjunction with the IT option table described in 
Figure 4.34. 

The number of entries is one more than the number of partitions supported, but 
with multiple timer and asynchronous processing supported, the table always 
comprises 16 entries. 
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TABLES REQUIRED BY 
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How to locate the IT request table 

Bytes X'50'-X'53' of the System Communication region (SYSCOM) contain the 
address of the IT Request Table. Label ITREQ identifies the first byte of the 
table. 



ITREQ 



r 



See 
Note 



< 






o 1 



Task 
Identifier 



— ■ 1 r 

Time Interval 



\ 



\ 



/ 



\ 



\ 



00 FF 00 00 00 



/ 



/ 



\ 



\ 



/ 

/ 




\ 
\ 


Byte : 


No SETI ME issued : 


X'OO', the last entry is always X'OO'. 




SETI ME issued 


PIK or TIK (X'10-X'FO') of the program or task 
that issued the SETIME macro. 


Bytes 1-4: 


No SETIME issued : 


Highest time interval possible (X'FFOOOOOO'). 
The last entry is always X'FFOOOOOO'. 




SETIME issued : 


Time interval that will elapse between the occurrence 
of the currently pending interrupt in SYSTIMER and 
the occurrence of the interrupt itself. The entries are 
in ascending order of magnitude, that is, the smallest 
interval appears first. 

The interval corresponding to the currently pending 
interrupt is in SYSTIMER (address X'50') and the 
key of the respective program or task is in TWTIMS. 



o 



Figure 4.35. Explanation of the contents of the IT option request table. 
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Abnormal termination support (AB) 

Abnormal termination exits are available for main tasks and/or subtasks, allowing 
you to gain control before an abnormal condition removes the task from the 
system. For example, in the abnormal termination routine, you can close your 
files. This function is provided by the AB operand of the STXIT macro. See 
Supervisor and I/O Macros for detailed information on the format and use of the 
STXIT macro. 






How to locate: 

Bytes X'54'-X'57' of the System Communication region (SYSCOM) contain the 
address of the AB Option Table. Label ABTAB identifies the first byte of the 
table. 



ABTAB 



See . 
Note ^\ 



v. 



BG 



F4 



F3 



F2 



F1 



Subtask 



Subtask 



Subtask 



3 4 

1 1 1 

AB Routine Address 



— i 1 1 

Save Area Address 



\ 



/ 



\ 



/ 



/ 



\ 



\ 



/ 



\ 



\ 



/ 



\ 



/ 



\ 



Bytes 0-3: No STXIT issued 

STXIT issued and 
rtnaddr parameter 
passed 



Bytes 4-7: 



No STXIT issued 
or no save area 
parameter passed 

STXIT issued and 
save area para- 
meter passed 



Zero. 



Address of entry point of user's abnormal termination 
routine. If AP (Asynchronous Processing) is supported 
the maintask and subtasks may have the same or 
different AB routines. When a subtask is ATTACHed 
after a STXIT AB macro has been issued by the 
maintask, the subtask will receive the AB routine 
address specified by the maintask only if the 
ATTACH macro for that subtask has the ABSAVE 
parameter specified. The subtask can override this 
by issuing its own STXIT AB macro. 



Zero. 



Address of a 72-byte save area used by the supervisor 
to store the interrupt status information and the 
contents of the general registers. (See Chapter 12.) 






Note: One table entry is generated for each partition supported. With asynchronous processing 
support, the table a/ways comprises 15 entries; the subtask entries occupy the higher 
address locations in the table. 

Figure 4.36. Explanation of the contents of the AB option table. 
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Page Fault Handling Overlap Support (PHO) 

This option enables a user routine to continue processing during the time a page 
fault, occurring in the same task, is being handled, PHO=YES in the SUPVR 
supervisor generation macro reserves an area in the supervisor for the PHO option 
table. Entries are made in this table when the user program issues a SETPFA macro 
instruction. The SETPFA macro instruction is described in DOS) VS Supervisor 
and I/O macros. If asynchronous processing (AP) is not supported, one entry is 
generated in the table for each partition supported by the system (NPARTS). If 
AP is supported, 15 entries are generated. 



TABLES REQUIRED BY 
USER EXIT ROUTINES 



o 



How to locate: 

Label PFATAB in the supervisor listing identifies the first byte of this table. 



r 



See 
Note 



< 



V. 



PFATAB 



BG 



F4 



F3 



■1 



F1 



Subtask 



Subtask 



Subtask 



3 4 



PHO 
Routine Address 



/ 



u 



Page Fault Information 



Flag Byte 



\ 



\ 



\ 



\ 



/ 



\ 



/ 



\ 



\ 



/ 



\ 



/ 



\ 



SETPFA issued 



Byte : Bit : 1= A page fault from the task is in the Page Queue Table. 

Bit 1 : 1= A page fault occuring in a supervisor service of the task is 

queued in the Page Queue Table. 

Bits 2-7: Unused. 

Bytes 1-3: Address of the user's page fault appendage routine. 

Bytes 4-7: Page fault information (for detailed layout see Page Queue Table). 

This information is stored here only when a page fault occurs in a supervisor 
service working for the task, while another page fault is queued for the 
task in the Page Queue Table; otherwise, zeros. 

NO SETPFA issued 

Bytes 0-7: Zeros. 



Note: One table entry is generated for each partition supported. With asynchronous processing 
support, the table always comprises 15 entries; the subtask entries occupy the higher 
address locations in the table. 

PFA TAB is only built ifPHO=YES was specified in the SUPVR macro at supervisor 
generation. 
Figure 4.37. Explanation of the contents of an entry in the PHO option table. 
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TABLES REQUIRED BY 
USER EXIT ROUTINES 



Program check support (PC) 

Program check (PC) support generates a PC table within the supervisor (see the 
Figure below). The address of a user program check routine is placed in the table 
via the STXIT macro issued by the problem program. If the STXIT PC linkage is 
established and a program check occurs within this program, the supervisor gives 
control to the user's routine instead of canceling the job being run in this partition. 
The support is extremely advantageous when using LIOCS. (For example, files can 
be closed before job termination.) If a program check occurs in a routine being 
executed from the logical transient area (LTA), only the task associated with that 
routine is abnormally terminated. 



In a multitasking environment each subtask and main task may have its own PC 
routine. A PC routine can be shared by more than one task within a partition. This 
can be done issuing a STXIT macro in each task with the same routine address but 
with separate save areas. To successfully share the same PC routine, it must be 
reenterable (capable of being used concurrently by two or more tasks). 



How to locate: 

Bytes X'64'— X'65' of the partition communication regions contain the address of 
the PC Option Table. Label PCTAB identifies the first byte of the table. 



PCTAB 



See 
Note'A 



BG 



F4 



F3 



1111 



F1 



Subtask 



V. 



Subtask 



Subtask 



PC Routine Address 



Save Area Address 



/ 



\ 



/ 



\ 



/ 



\ 



/ 



\ 



/ 



\ 



/ 




\ 


Bytes 0-3: 


No STXIT issued 


Zero. 




STXIT issued 


: Address of the user Program Check Routine. 




STXIT issued and 






the user routine 






is already in use 


Complement of user Program Check Routine address. 


Bytes 4-7: 


No STXIT issued 


Zero. 




STXIT issued 


Address of the user Save Area. 






Note: In a supervisor without multiprogramming support, there is only one entry (BG) in each 
generated table. With multiprogramming support, there is one entry for each partition 
supported. 

With asynchronous processing support, each generated table always comprises 15 entries; 
the subtask entries occupy the higher address locations in the table. 

Figure 4.38. Explanation of the contents of an entry in the PC option table. 



o 
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Operator communications support (OC) 

Operator Communications (OC) refers to the processing of an external interrupt 
by a problem program. In a multitasking environment, only the main task can 
communicate via the OC linkage. By specifying OC=YES, a table (OC option table) 
is generated within the supervisor (see Figure below). When the problem program 
issues the STXIT macro, the address of its external interrupt routine is moved to the 
OC option table. The user's routine is terminated by issuing the EXIT macro. When 
OC=YES is specified, support is available to all partitions. 



TABLES REQUIRED BY 
USER EXIT ROUTINES 



o 



© 



How to locate: 

Bytes X'68'-X'69' of the partition communication regions contain the address of 
the OC Option Table. Label OCTAB identifies the first byte of the table. 



r 



See i 
NoteS 



OCTAB 



BG 



F4 



F3 



III! 



F1 



Subtask 



Subtask 



Subtask 



OC Routine Address 

i i i 



1 1 1 

Save Area Address 



\ 



/ 



\ 



\ 



\ 



\ 



\ 



\ 



\ 



\ 



/ 




\ 


Bytes 0-3: 


No STXIT issued 


Zero. 




STXIT issued 


Address of the user Operator Communication 
Routine. 




STXIT issued and 






the user routine 






is already in use 


Complement of the user Operator Communication 
Routine 


Bytes 4-7: 


No STXIT issued 


Zero. 




STXIT issued 


Address of the user Save Area. 



Note: In a supervisor without multiprogramming support, there is only one entry (BG) in each 
generated table. 

With multiprogramming support, there is one entry for each partition supported. 
With asynchronous processing support, each generated table always comprises 
15 entries; the subtask entries occupy the higher address locations in the table. 

Figure 4.39. Explanation of the contents of an entry in the OC option table. 
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Partition Save Areas and Label Save Areas 

Each partition contains a save area for program name, old program status word, 
and registers. 

Following the partition save area, each partition contains a label area for label 
processing if the LBLTYP statement is used. Both areas are at the low end of the 
partition. 

Save area length = 88 (dec) bytes or, if the floating point feature is supported, 
120 (dec) bytes (FP=YES specified in the CONFG system generation macro). 

Label area length is determined by the system according to the LBLTYP card 
specification: 

• TAPE (standard tape labels) = 80 bytes 

• NSD (nn) (nonsequential disk) = 84 bytes + 20 bytes per extent statement 

• Omitted = 0. 

Figure 4.41 (opposite) illustrates the location of the partition and label save areas 
in virtual storage for a system supporting multiprogramming. The figure below 
shows an example of a background program partition, save area as it is printed in a 
system dump. The programmers remarks on the figure indicate how the programmer 
used the save area during offline debugging. 




c 



Figure 4.40. An example of a system dump output showing the partition save area. 

The programmer's remarks on the dump show areas of immediate interest during 
offline debugging. 



How to locate: 

The addresses of the partition save areas are stored in the problem program PIB, 
described in Chapter 7 in this Section. 



J 
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SPVR -< 



BG 



FG 



> 



< 



> 



< 



Supervisor Area 



Background program save area. 



Label save area. (See note 1 ). 



Background program area. 



Foreground program save area. 



Label save area. (See note 1 ). 



Foreground program area. 




Other foreground program save areas. 



label save areas, 



and program areas have 
similar layouts. 



Program name (8 bytes) 



Return PSW (8 bytes) 



General Registers 

9 through 8 (64 bytes) 



Length of Label Area (2 bytes) 
See note 4 



Reserved (6 bytes) See note 2 



Floating Point Registers 
32 bytes 
(See note 3) 



Program name (8 bytes) 



Return PSW (8 bytes) 



General Registers 9 through 8 
64 bytes 



Length of Label Area (2 bytes) 
See note 4 



Reserved (6 bytes) See note 2. 



Floating Point Registers 
32 bytes 
See note 3. 



Note 1: 



o 



Length of the label area depends on the amount of storage specified by LBLTYP 
statement: 



For standard tape labels (any number)-80 Bytes 

For sequential DASD and DTFPH MOUNTED SINGLE-0 Bytes 



Note 2: 
Note 3: 



Note 4: 



For DTFIS, DTFDA and DTFPH MOUNTED ALL-84 Bytes plus 20 Bytes 

per extent. 
Job start time, for time stamp, is stored in last 4 bytes of this area. 
Floating point register save area is required only when floating point feature is 
specified at supervisor generation. 

Only non-zero if a // LBL TYP statement read before the current job step. Otherwise 
reserved by the linkage editor, but not entered in these bytes. 



Figure 4.41 . Organization of partition save and label save areas. 
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ABSAVEarea 

In all abnormal termination conditions where an exit is taken to an abnormal 
termination routine specified and written by the user, the register values are stored 
in the ABSAVE save area before the appropriate error code is stored in the low- 
order byte of register 0. To have this value available when looking at a storage 
dump you should store (STC or ST) register in another save area upon entry into 
the abnormal termination routine. You will find that the SVC code shown in the 
"0S04I ILLEGAL SVC— ..." message along with the error codes in register 
will be helpful in tracing program errors. Each user exit routine must have its own 
save area in order to preserve the contents of the 16 general registers and interrupt 
status information at the time the exit routine is entered. The address of the save 
area is specified in the STXIT macro and is contained in the appropriate option 
table. 

Figure 4.42 (opposite) illustrates the format and contents of the Interrupt Status 
Information (the first 8 bytes of the save area). Details about the STXIT macro 
can be found in DOS/ VS Supervisor and I/O macros, and details about the option 
tables in the DOS/VS Supervisor Logic. 
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STXIT -t 



IT 
PC 
AB 
OC 



Routine 
address 



( ^ 

Save area 
address 



Exit Routine 



General 

Registers 

0-15 



X'48' byte save area 
for user exit routines 
IT, PC, AB,OC. 
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SAVE AREAS 



Reserved 


Key 


1 

MWP 


' Interruption Code 


ILC 


CC 


Program 
Mark 


Instruction Address 



^^gijjirt 1 



12 is always set to 1 
Bit 1 3 if set to 1 , enables machine check interrupt 
Bit 14 if set to 1 , indicates CPU wait state. 
Bit 15 if set to 1 , indicates CPU in problem state 
if set to 0, indicates CPU in supervisor state 



Interrupt codes , 
for PC: \ 



Interrupt code 
for IT: 

Interrupt codes 
for OC: 



Always 






X'00' 




Cause of Program 
Interrupt 


x'or 


00000001 


Operation 


X'02' 


0000001 


Privileged operation 


X'03' 


0000001 1 


Execute 


X'04' 


00000100 


Protection 


X'05' 


00000101 


Addressing 


X'06' 


00000110 


Specification 


X'07' 


000001 1 1 


Data 


X'08' 


00001000 


Fixed point overflow 


X'09' 


00001001 


Fixed point divide 


X'OA' 


00001010 


Decimal overflow 


X'OB' 


00001011 


Decimal divide 


X'OC 


00001100 


Exponent overflow 


X'OD' 


00001101 


Exponent underflow 


X'OE' 


00001110 


Significance 


X'OF' 


00001 1 1 1 


Floating-point divide 


X'10' 


00010000 


Segment translation 


x*ir 


00010001 


Page translation 


X'12' 


00010010 


Translation specification exception 


X'13' 


00010011 


Special operation exception 


X'40' 


01000000 


Monitor call 


X'8*' 


1XXXXXXX 


PER event, where x = code 

for cause of program 


X'80' 


10000000 


Timer check. For example, a 
PER + a data exception 


X'40' 


01 000000 


External = X'87' (100001 1 1 ). 



o 



Figure 4.42. The format and contents of the user exit routine save area and 

interrupt status information. 



Debugging for Programmers, part 2. 4.109 



Section 4, Chapter 11 

SAVE AREAS System Save Areas (for system tasks) 



There are occasions when task information must be saved by the page manager. 
For example, page faults may occur when supervisor services are executed under 
control of user PIBs. Because the user's partition save area is occupied during this 
time, an additional system save area for each user task is provided. 

The information saves is contained in a 72-byte (dec) field, and includes the return 
PSW and 16 general purpose registers belonging to the interrupt supervisor task. 
The registers are stored in numerical sequence beginning with GR9. The save areas 
for all tasks (maximum of 15), are within the supervisor area. The address of each 
user task save area is recorded in the program information block. (Refer to Chapter 
7 in this Section.) 

Immediately following each save area is an area reserved for the CCW/TCB (Channel 
Command Word/Translation Control Block), the format and contents of which is 
described in Chapter 1 3 in this Section. The addresses of system (task) save areas 
are contained in the system communication region, refer to Chapter 2 in this 
Section. 






I 
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Save Areas for the Job Accounting option 

If the J ALIOCS parameter is specified in the FOPT supervisor generation macro, 
two save areas are reserved in the supervisor. 



JALIOCS= 



NO 

(s, 1) 



Section 4, Chapter 1 1 

SAVE AREAS 



NO indicates that no special LIOCS support is required. Specification of (s, 1) 
indicates that a user save area and a label area are to be reserved. 

S is the decimal number of bytes to be reserved for the user save area (located in 
the supervisor). This save area may be used to save DTF information or for any 
other purpose desired by the user. The system does not access this area. (The 
address of the save area is available in register 13 when $JOBACCT is called.) 
The valid range of s is 0-1024, with a default of 16. 1 is the decimal number of 
bytes needed for a label area. This label area replaces the one normally used by 
LIOCS label processing. It is required when $JOBACCT uses LIOCS for such 
things as standard tape labels, DTFDA, and DTFPH with MOUNTED=ALL. The 
valid range of 1 is 0-224, with a default of zero. The value that is substituted for 
1 is normally the number of bytes that would be allocated by a given parameter 
on the LBLTYP statement. See Figure 4.41 in this Section to determine 
the number of bytes allocated for any given LBLTYP statement. 

If the JA parameter is specified and JALIOCS is not the job accounting interface is 
generated but no alternate label area is reserved (16 bytes are reserved for the 
save area). The routine $JOBACCT must then use a device or method that does 
not require LIOCS label programming. If the JA parameter is not specified, the 
JALIOCS parameter is ignored. 



o 
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PAGE MANAGEMENT 
TABLES 



The purpose of this chapter is to describe the tables that are used by the page 
management routines which may need to be inspected during program debugging. 
A knowledge of the concept of virtual storage is assumed. 



The Segment Table 

One segment table is generated within the supervisor area during system generation. 
Each entry in the segment table corresponds to one 64K segment of virtual storage. 



4~\ 



How to locate: 

The address of the first entry in the segment table is contained in bytes X'DO' to 
X'D3' of SYSCOM. Label STAB in the supervisor listing identifies the address of 
the first byte of the segment table. The address of the segment table is also 
contained in control register 1. Refer to the example shown in Figure 4.47. 



The Page Table 

One page table is generated for each segment of virtual storage during system 
generation. Each page table is 64 (decimal) bytes in length, and has 32 two-byte 
entries. Each entry corresponds to 2048 (decimal) bytes of virtual storage. As 
illustrated in Figure 4.46, the page tables occupy a consecutive area in the 
supervisor. 



Initialization of the Page Table 

After IPL, page table entries are initialized as follows: 

• All page table entries belonging to the supervisor area (nucleus and 
transient areas): 

Bit 13 = 

Bit 15 = 

Bits 0- 12 = the leftmost 13 bits of the address of the corresponding 

page frame. 

• All page table entries for allocated real partitions: 
Bit 13 = 

Bit 15= 1 
Bit 0=1 
Bits 8-11= storage key of the partition. 

• Page table entries belonging to virtual partitions: 
Bit 13 = 1 

Bit 15=1 
Bit 0=0 
Bits 8-11 = storage key of corresponding partition. 

• All remaining page table entries: 
Bit 13 = 

Bit 15= 1 
Bit 0=1 
Bits 1-12 = 






i 



J 



4.1 1 2 Debugging for Programmers, part 2. 



Section 4, Chapter 12 



o 



How to locate 

The address of the page table belonging to the first 64K of virtual storage is 
contained in the first entry in the segment table. 

The address of the page table belonging to subsequent segments of virtual storage 
are contained in the associated segment table. Refer to Figure 4.46 which illustrates 
this. 

Appendix G shows an example of locating the segment table and page table in a 
dump. 

Figure 4.43 (below) shows the format and contents of an entry in the segment 
table and an entry in the page table. The figure also illustrates the interconnection 
between these two tables. 



STAB (Segment table) 



X'FO' 



X'FO' 



X'FO' 



X'FO' 



Address of 
Page Table 



Address of 
Page Table 



Address of 
Page Table 



Address of 
Page Table 



Each entry in the 
segment table 
corresponds to one 
64 K segment of 
virtual storage. 

One page table is 
built for each seg- 
ment of virtual 
storage and W 

contains 32 two-byte 
entries. 



PT (Page Table) 



PAGE MANAGEMENT 
TABLES 



Bytes and 1 


BitO 


: 1 = Address of any byte in the corresponding page 
is invalid, that is the page is not in real storage 




Bits 0-1 2 


Leftmost 1 3 bits of address of page in real storage 
if bit 13=0. 




Bits 8-1 1 


: Storage key of corresponding partition if bit 13= 1 . 




Bit 13 


= Page is in real storage; 

1 = Page is not in real storage. 




Bit 14 


: Always zero. 




Bit 15 


: = Page must be read from page data set, (a valid 
copy of the page is on SYSVIS); 

1 = Page need not be read from page data set, (there 
is not a valid copy of the page on SYSVIS). 



Note: Label STAB identifies the first byte of the table 

Label PT identifies the first byte of the Page Table. 



o 



Figure 4.43. Explanation of the contents of an entry in the Page Table. 

This figure also illustrates the relationship between the page table and the segment table. 
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Page Frame Table 

The page frame table is built at supervisor generation time and contains one 8-byte 
entry for each 2K block of real storage (page frame) as specified in the RSIZE 
parameter of the VSTAB macro. 






How to locate: 

Bytes X'D4'-X'D7' of the SYSCOM contain the address of the first entry in this 
table. Label PFT in the supervisor listing identifies the address of the first byte 
of this table. 

The format and contents of an entry in the page frame table is shown below. 



■ 




1 


2 


3 


4 


5 


6 


7 



\ 



\ 



\ 



\ 



\ 



Bytes and 1 



Bits 0-10 
Bit 11 
Bit 12 
Bit 13 
Bit 14 
Bit 15 



Bytes 2 and 3: 



Bytes 4 and 5: 



Bytes 6 and 7: 



Counter for temporary fixes (tfix counter.) 

Reserved for later use. 

1= PFIX request (into another page frame) pending for the page . 

If on, page frame is unusable (hardware failure). 

If 0, page frame belongs to selection pool 

1= PFIX (different page) or GETREAL request pending for the page frame. 

Pointer to next page frame in queue or to queue header if last element 
in the queue (all page frames in selection pool are queued). 

If the frame is occupied, the page number (The virtual address of the 
page divided by 2048); if unused, X'FFFF'. 

Pointer to the previous frame in the queue or to queue header if first 
element in the queue (all page frames in the selection pool are queued). 



Figure 4.44. Explanation of the contents of an entry in the Page Frame Table. 

Page frame table extention (PFTX) 

This table is a one-byte appendage to each entry in the page frame table. It serves 
as a counter for the number of times a page has been permanently fixed in a page 
frame, and is labeled PFIX counter. 

How to locate 

Bytes X'D8' - X'DB' of SYSCOM contain the address of the first entry in this 
table. Label PFTX in the supervisor listing identifies the address of the first byte 
of this table. 



/T 
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Boundary Box 

This information block is generated in the supervisor during system generation. 
The area occupied by the boundary box is sufficient to contain up to six entries, 
depending on the number of partitions specified during system generation. The 
first entry contains information about virtual storage allocation, and the remaining 
entries contain information pertaining to each partition supported by the supervisor. 
If a partition is not supported by the supervisor, the beginning and end addresses 
are identical to those of the next partition. 



PAGE MANAGEMENT 
TABLES 









How to locate: 

Bytes X'DC - X'DF of SYSCOM contain the address of the first entry in this 
information block. Label BBOX in the supervisor listing identifies the address of 
the first byte of this information block. Appendix G shows an example of locating 
the boundary box in a dump. 

The format and contents of the boundary box is shown below: 



3 


4 5 


6 7 


8 11 


12 


15 


End Address of Real Storage 


Number of 


Number of 








or Address of Alternate Area 


Page Frames 


Page Frames 


Begin Address of Virtual 


End Address of Virtual 




for PDAID or the start 


in smallest 


in Main Page 


Address Area 


Address Area + 1 




of the SD area for SDAID 


Real Partition 


Pool 









Fojrmat of the 
General Entry 



BBOX 



General Entry 


BG Entry 


F4 Entry 


F3 Entry 


F2 Entry 


F1 Entry 



■~\ 



> 



The number of entries is equal 

to the number of partitions (NPARTS) 

specified at system generation + 1 . 



3 4 



Format of 
any entry 
7 8 



11 12 



-15 



Begin Address of 
Real Partition 



End Address of 
Real Partition + 1 



These values are inserted at IPL time but can be changed 
by ALLOCR command. 



Begin Address of 
Virtual Partition 



End Address of 
Virtual Partition + 1 



These values are inserted at system generation time but can 
be changed by the ALLOC command. 



Note: The begin and end address fields for a partition that is not allocated contain the begin and end addresses of the following partition. 
Figure 4.45. Explanation of the contents of the Boundary Box 
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PAGE MANAGEMENT Converting virtual to real addresses and vice-versa 

TABLES 

There are several methods of calculating real addresses from virtual and vice versa. 

One method is given below. 

(The values assumed in the examples apply to the illustration opposite.) 

A. Converting a virtual address to real: 

1. Write the hexadecimal virtual address in binary. For example (assuming 
a virtual address of 1FA20), 

^*-1 F A20 — _____^ 

0001 1111 1010 0010 0000 

2. Ignore the ten rightmost bits. For the example, this leaves 

0001 1111 10 

3. If after step 2 the rightmost bit is a 1 , change it to a 0; if it is a 0, 
leave it 0. 

4. Convert the binary value obtained in step 3 to hexadecimal. 
For example, 

0001 1111 10 

— i r~ 

7 E 

5. Locate the address of the page table, contained in the first entry of 
the segment table, the address of which is contained in CR1. (For 
example shown opposite, this is 6A28,) 

6. Add the address of the page table to the hexadecimal number obtain'ed 
in step 4. 

For example, 

6A28 

+ _ZE 

= 6AA6 (This is the address of the entry in the page 
table associated with the virtual address to be 
converted to real. ) 

7. Locate the page table entry in the dump. 

8. Replace the right most bit of the contents of the page table entry 
by a 0. 

For example, as shown in the illustration opposite, the page table 
at address 6AA6 contains 01B9. The right most bit is a 1 (X'9' = 
1001.) 

9. After replacing the right most bit by a 0, convert the resulting four-bit 
binary string to hexadecimal. 

For the example, 1000 - X'8\ 

The value thus obtained in this example is 01B8. 

10. Increase the value obtained in step 9 by attaching two 0s to the right. 

For example, 01B800 (This number is the address in real storage 

of the lower limit of the page frame in which 
the real address is located.) 

1 1 . Convert the eleven rightmost bits of the binary value obtained in step 1 
to hexadecimal. 

For example, 

010 0010 0000 

-I 1 — — f— 

2 2 

12. Add the value obtained in step 1 1 to the number obtained in step 10. 

For example, 

01B800 
+ 220 

01BA20 (This is the real address.) 
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Bytes X'D0-D3' of SYSCOM 

and 

Control register 1 

contain the address 
of the segment table. 



00006C80 






o 



FO 00 6A 23 
6A 68 



6A_A8 
6A E8 
6B 28 
6B 68 
6B A8 
6B E8 
6C 28 



Segment table 
Each entry 
represents 
64K (dec) 
of virtual 
storage. 



Page table 

Each entry represents Real address area 

2048 (dec) bytes of ' f the invalid-bit of the 

virtual storage. There page table entry is 

are 32 entries in set (=1 ), the page 

the page table for each resides in the real address 

entry in the segment area. 

table 



0000 



0008 
0010 



\ \ 
\ ' 
\ 



\ \ 



0000 00 



00 08 00 



// 



00 10 00 



01 B0 00 



01 B8 00 



01 CO 00 



3F 00 00 



3F7F FF 



PAGE MANAGEMENT 
TABLES 

Page frame table 

Each entry represents 2048 (dec) 
bytes of the real address area, and 
indicates the status of the 
attached page. 



00 3F 



Page frames 
allocated to 
the supervisor 



Page frames 
allocated to 
( partitions running 
in real mode 



Page frames 
f- allocated to 
the page pool 



End of real storage 



Explanation of the illustration. 

The segment table in this example starts at address 6C80. 

The page table starts at address 6A28. 

Three valid entries in the page table are shown allocated to three consecutive 

2K slots in the real address area. (The associated entries in the page frame 

table are indicated.) 

The page entry at address 6AA6 contains a value of 01B9 which is used in the 

example given on the opposite page. 

Figure 4.46 illustrates the relationship between the page management 
tables that are described in this chapter. 
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PAGE MANAGEMENT Converting a real address to virtual: 

TABLES 



1 . Write the hexadecimal real address in binary. For example, 

^01BA20i 

± A. 



0000 0001 1011 1010 0010 0000 

2. Ignore the eleven rightmost bits. Thus, for the example, 

0000 0001 1011 1 is the remaining binary number. 

3. Add three 0s to the right of the binary number obtained in step 2. 

Thus 

0000 0001 1011 1000 

4. Convert this binary value to hexadecimal. 

For example, 

0000 0001 1011 1000 

n r "i~ ~t- 

1 B 8 

5. Add the number obtained in step 4 to the address of the page frame 
table. Bytes X'D4' - X'D7' of SYSCOM contain the address of the 
page frame table. (For the example, this is assumed to be 6100.) 

For example, 

6100 
+ 1B8 

= 62 B8 

6. Locate this address in the dump. (This is the address of the page frame 
table entry associated with the real address to be converted.) 

7. Locate bytes 4 and 5 of this page frame table entry. (For the example, 

as illustrated in Figure 4.46, a value of 003 F is assumed.) /f j 

8. Write this hexadecimal number in binary. 

Thus for the example, 

0000 0000 0011 1111 

9. Ignore the leftmost three bits, and add three 0s to the right hand end 
of the resulting binary string. 

Thus, 

0000 0001 1111 1000 

~~r ~r~ ~~r — r 

1 F 8 

1 1 . Convert the eleven rightmost bits of the real address (as written in 
binary in step 1) to hexadecimal. 
For example, 

010 0010 0000 



2 2 

12. Add the number obtained in step 10 to the number obtained in step 1 1 
For example, 

01F800 
+ 220 



01 FA20 (This is the virtual address.) 
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EVENT PGM CHK INTERRUPT TOO MICSEC 

GPR O-T 

GPR 8-F 

CTl 0-7 

CTL 8-F 

LOW CORE 

00000000 

00000020 

000000*0 

00000060 

00000080 

OOOOOOAO 

OOOOOOCO 



SUPERVISOR 
00000120^00000000 



0000001B 00040910 00000021 
00000000 00000000 00000000 
004000FF( OOOOE640 )FFFFFFFF 

&£&, °coooo 

" t **"' 020007 
00000000 20000060 

ooooooooloooooooo 00000000 

Adobe™ o/ 
SYSCOM 



2333009458490780 PSH AT TIME OF EVENT 4710300000<j4071§) INSTR DE03C676C5EC 
00000003 0000002E 00000000 00000000 OOOOOOOO 
*""»""'" n«n*m-»« "-"-.8C1E2 A00406EE 000422AO 



OOOOFFFF 

OOOOOOOO 
47100000 
10O0E7F0 
44 OC 00 00 
L0000054 
0000000 






)00000 OOOOOOOO OOOOOOOO 

JOOOOO C2000000 00000200 

COMAe'Cjr ) jp4 A o) 40000000 OOOOOOOO 

J3E974 470C2000 OOOO09OC 

F258BC00 01AAAB17 440C00O0 OO0O0C14 

04080000 000OD13A 440C0OO0 00000810 

12042003 00020000 OOOOOOOO 000001CC 

OOOOOOOO 00000100 OOOOOOOE OOOOOOOO 

OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 



000004AO 
000004C0 
000004EO 
00000500 

ooooc 

Q0000S40] 

00088560 

00000580 
000005AO 
000005CO 
000005EO 
00000600 
00000620 



— SAME — 

F1F261F0 

00060FFF OOU4232F 0O04232F 

41044296 42974389 3F003F06 

46300000 3DCC3E4C 3EBC0010 

OOOOOOOO 04A010E0 00000588 

00006140 ooooJKa oSflAi57CO 



00000010 
3F0C38F1 
OOOOOOOO 
C0CC0340 

0038*134 



00017C00 020050E6 0032002C 
608C0800 000008FC 00009260 
OOOOOOOO 00007998 00006360 
OOOOA5E2 00009710 C00006RC 
00081018 00200000 OOOOOOOO 
OOOOOOOO OOOOOOOO cooooooc 
001063D8 OOOOOOOO OOOOOOOO 000 3FFFF 



TAIiL£ 

404otutu . _ . . . . ._■■.. 

(0004888 66865854 0000. 






00050000 
00005F78 
00003854 1 
OOOOOOOO \ 
OOOOOOOO «£ 
01410001 E 



C66026C4 

0000700C[ OOOOOOOO 00008299 009060B8 
00006063 000060C0 00000010 OC0074B0 
000006381 00008099 00004246 >OO0O0760 
IOOOC034\00008E60 00003A8CJ OOOOOOOO 
1 00001^00 JMQ0039 32 OOOOOOCOMOOOOOrO- 
I0C00E640 IOOOOUE88lOOOOE2BoT60006^'l , a 









—ysX'Dc'-X'tF. - 

\SV5C0M 



3778 C0Q0P13C 



00004920 AOO 70000 1 00010043 oU^OflYn ...Q . 

0000H2Bn HOC C'OOCO OOOAOOPO ^0001000 P. ..J... U* *?A #?) 






*dg 



00000E60 
0000DE80 
OOOODEAO 
OOOODECO 
OOOOOEEO 
OOOOOFOO 
0OOODF2O 
00000F40 
00000F60 
OOOODF80 
OOOODFAO 
OOOODFCO 
OOOOOFEO 
OOOOEOOO 
00OOEO2O 
O00OE040 
OO00EO60 
O000E080 
OOOOEOAO 
OOOOEOCO 
OOOOEOEO 
0000E100 
0000E120 
O0OOE140 
OOOOE160 
00OOE18O 
0000E1A0 
OOOOEICO 
OO0OE1E0 
OOOOE200 
0O0OE22O 
0000E240 
OOO0E260 
00O0E28O 
0OOOE2A0 
0000E2C0 

0000E320 
0000E340 
O0O0E360 
0000E380 
0000E3A0 
O0O0E3CO 
0000E3E0 
O00OE400 
0000E420 
0000E440 

0O0OE4A0 
0OO0E4C0 

0000E500 
0000E520 
OO0OE540 
O0OOE56O 

OOO0E5A0 
OOOOE5C0 

0000E620 
OOOOE640 
0OOOE66O 
0000E680 



OOOOOOOO 
OOOOOOOO 



OOOOOOOO 

ooooooool 



OOOOO OOOOOOOO 



00020COO 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00000170 
00000340 
000001 EO 
OOOOOIDO 
00000208 
00000220 
00000240 
00000250 
00000270 
000002BO 
00000330 



0003000) 

00070000' 

OOOBPOOO 

OOOFOOOO 

00130000 

00170000 

001BOOOO 

OOIFOOOO 

00230000 

00270000 

002BOOOO 

FFFF0180 

FFFF0338 

FFFF0230 

FFFF01E8 

FFFF0200 

FFFF0210 

FFFF0248 

FFFF0260 

FFFF0280 

FFFF0290 

FFFF0368 



000200_00 
'0020000 
002000J 

(ft! 

00020000 
00020000 
00020000 
00020000 
00020000 
P0020000 
00020000 
00020000 
00000178 
000001A8 
000001FO 
C00001C8 
000001F8 
00000228 
00000200 
00000258 
00000278 
00000338 
00000180 



oo< '/%*/*"« ° 
01 raax- O 

0] Ftcctnt. 1 A** / 





001 

00200000 

00240000 

00280000 

002CO000 

FFFF02C0 

FFFF0188 

FFFF01C8 

FFFF01B8 

FFFF0240 

FFFF0218 

FFFF0238 

FFFF0268 



00020000 
0C020000 



JPJLOJJO.OQa' 000200O0 
on n* 0000^00020000 

' 0000I00020000 

000/00020000 

oqfiro 00020000 

,0000 00020000 
" '0000 0002QJ 

!ooeo 

I20000 

00020000 

(0000020000 



I00020000 



000002E8 

J 00000208 

00000418 008002C8 100000410 008102E8 I000002E0 



000001A0 
OOOOOIBO 
000001CO 
000001D8 
00000210 
00000230 
00000238 
00000260 

FFFFOIBO 00000290 

FFFF02B0 

FFFF02F0 



FTFT0190 
FFFFOIAO 
FFFF01EO 
FFFF01F0 
FFFF01F8 
FFFF0220 
FFFF0250 
FFCF0270 
FFFF0170 



300 100000288 



00000300 
00000320 
00000198 
00000350 
00000370 
000003AO 
000003C0 
000003EO 
00030330 



000002C8 
OOOOOOOO 
— SAME — 
OOOOOOOO 



FFFF0328 
FFFF0310 
FFFFO2A0 
FFFF0360 
FFFF0348 
FFFF0390 
FFFF03BO 
FFFF0300 
007F02F8f 



00000190 
00000308 
00000360 
00000358 
00000388 
000003A8 
000003C8 
00000400 



FFFF02F8 06666328 

FFFF0318 000002F8 

FFFF0198 00000378 

FFFF0340 000002B8 



00830410 
00840418 
008202A8 



FFFF01DC 
FFFF0398 
FFFF03B8 
FFFF03D8 



00000390 
000003BO 
000003DO 
00030330 



FFFF0320 
FFFF0308 
FFFF0350 
FFFF0370 
FFFF0380 
FFFF03A0 
FFFF03C0 
007D03FO 



00000188 
00000280 
00000380 
000001E8 
00000218 
000001B8 
00000248 
00000268 
00000298 
000002AO 
000O02F0 
000002CO 
00000318 
00000310 
00000348 
00000368 
00000398 
000003B8 
00000308 
00030330 



00020000 
00060000 
OOOAOOOO 
OOOEOOOO 
00120000 
TSO 
OOIAOOOO 
001EOOOO 
00220000 
00260000 

(FFF FD178 



000002D8 
OOOOOOOO 



OOOOOOOO 



00000200 
00000420 
OOOOOOOO 



000003EO 00000408 00000408 
00000420 ^/» r fiiag. 



00400048 
00C0OOC8 
01400148 
80118011 
80418041 
80518051 
80518051 
318001 



00500058 
O0DOO0D8 
01500158 
80118011 
80418041 
80518051 
80518051 
80018001 



OOOOOOOO 
00600068 
OOE000E8 
01600168 
80118021 
80418041 
80518051 
80018001 
800103E9 



OOOOOOOO /" 
OOOOOOOO J o oook 



000002A8 
OOOOOOOO 
OOOOOOOO 



fFPfoIco 

FFFF01A8 

FFFF01D8 

FFFF01C0 

FFFF0208 

FFFF0228 

FFFF0258 

FFFF0278 

FFFF0288 

FFFF0298 

FFFF0400 

FFFF02D0 

FFFF0330 

FFFF02 

FFFF0358 

FFFF0378 

FFFF0388 

FFFF03A8 

FFFF03C8 

007E03F8 



1 



00150015 
— SAME — 
00150015 



00700078 " 00800088 
O0F0OOF8 01000108 
80118011 80118011 
80218021 80218021 

80518C"- -"" " 

805 18C '<■ 

80018C 
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Figure 4.47. An example of an SDAID "dump on program check" showing how 
to locate the page management tables. 
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Channel program translation 

This chapter describes the control blocks used by the DOS/VS channel program 
translation routines, which may require examination under certain circumstances 
of a system malfunction. 



I/O operations and of virtual storage 

For a full description of the channel program translation routine, refer to the 
DOS/ VS Supervisor Logic manu al . 



General functions 

Because the DAT (dynamic address translation) feature is not available for data 
and channel command words of I/O operations, software routines are required that 
perform the following functions for an I/O request from a virtual partition: 

1 . The CCB and, if applicable, the user sense CCW will be copied into a buffer. This 
buffer is called the CCB copy block and is maintained by the CCW-translation 
buffer management. 

If a second I/O operation from a virtual partition is requested, the copied and 
translated CCB is queued behind the first request in the CCB copy block queue. 
Label ACCBB in the supervisor listing points to the address of the CCB copy 
block queue. Displacement X'44' from this address contains the address of the 
second CCB copy block. 

2. The complete channel program, consisting of one or more CCWs, will be copied 
into a buffer area called the CCW copy block. The copied channel program is 
logically equivalent to the original channel program, the data addresses being 
translated to real addresses. The copy process conserves the channel program 
structure, but TIC (transfer in channel) commands will be inserted in the copied 
channel program when there are more than seven CCWs in a channel program. 
Figure 4.51 shows a channel program having eleven CCWs; two copy blocks that 
are linked by a TIC command are therefore required. Figure 4.52 illustrates the 
format and contents of the CCW/TCB. 

3. Addresses in the copied channel program that refer to an I/O area in a virtual 
partition are translated into the corresponding real addresses. If the I/O area is 
completed on one page, the real address will replace the virtual address in the 
copied channel program. If the I/O area occupies more than one page (crosses 
page boundaries), an IDAL (Indirect Data Address List) block is built up. The 
IDAL block contains the real address of the I/O area and the real page addresses 
of any pages occupied by the I/O area. The address of the IDAL will replace 
the virtual address in the copied CCW, and the IDAL bit (bit 37 in the CCW) 
will be set to 1 . If the virtual channel program already uses the IDA feature, 
both the IDAL from the virtual partition copied and the virtual addresses will be 
replaced by the corresponding real addresses. 

Figure 4.48 illustrates the actions described in points 1, 2 and 3 above, and 
Figure 4.49 illustrates the relationship between the blocks described. 
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User-task 



EXCP 



Via dispatcher 



• Copy CCB 

• Copy CCWs 

• Translate copied CCB 

• Fix data areas 

• Build IDALS (if required) 

• Translate copied CCWs 

• Enqueue request to channel 
queue 

• Start I/O 



user-task 






Under PI K of usertask 
that requested I/O 



Via dispatcher 



• Move parts of copied CCB 
to original CCB 

• Release buffer of copied CCB 

• Reset indicator for moved 
CCB 



l/O-interrupt handler 



l/O-interrupt belonging to above 
mentioned l/O-request 

• (handle ERP) 

• Transfer interrupt information 
from CSW to copied CCB 

• Post CCB, post task dequeue 

• Request from channel queue 

• Retranslate CCW- address in 
copied CCB to virtual free 
data areas 

• Release copy buffers, except 
that of CCB 

• Set indicator and move CCB 
if necessary 



Under PI K of interrupted task 



o 



Figure 4.48. Illustrates the activity between user program and supervisor during 
the handling of an I/O request from a program running in virtual 
mode. 
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Additional functions performed by the channel program translation routine are: 

4. A sense CCB (if applicable) is updated in the copied CCB. 

5. All I/O areas required by the channel program must remain in real storage until 
the I/O operation is complete. For this reason all pages involved with an I/O 
operation are fixed in real storage. 

After the above functions have been performed, the I/O request is handled as if it 
were a request from a real partition. The following supervisor activity then ensues.- 

1 . The request is placed in the channel queue. 

2. A START I/O is issued. 

3. The corresponding interrupts are processed. 

4. The ERPs are activated (error recovery procedures in case of I/O device errors). 

5. Status information is posted in the copied CCB. 

6. The request is removed from the channel queue. 

After completion of an I/O request from a virtual partition, the channel program 
translation routine translates the real command address (from the CSW) to the 
corresponding virtual address, frees all fixed pages that were required by the 
request, transfer parts of the copied CCB to the virtual CCB, and releases all areas 
used by the buffers required by the channel program translation routine. 

Figure 4.48 illustrates the complete operation described above under points 1 
through 5. 



IDAL block 

The IDAL block is generated by the CCW translation routine if the I/O area 
specified in a CCW crosses page boundaries. The IDAL blocks are placed in the 
buffer area at the end of the supervisor together with associated CCB and CCW 
copy blocks. Each block contains real addresses of the data areas in real storage. 
Because each address is 4 bytes in length, an IDAL block can contain up to 1 8 
addresses (also referred to as IDA words.) Each IDAL must be completely 
contained in one IDAL copy block. If more than one I/O request requires an IDAL, 
as many IDALs are placed in one IDAL copy block as will fit. 

The figure opposite shows the relationships between the blocks. 

Appendix G shows an example of locating a CCB copy block and CCW copy 
block in a stand-alone dump output. The CCB address in the channel queue is used 
as the initial pointer. 






CCB copy block 

CCB copy blocks are placed in a buffer area (specifically reserved for the channel 
program translation routine) at the end of the supervisor together with the 
associated CCW copy blocks and IDAL block (if required). Each CCW copy block 
consists of nine entries. The first seven entries are used to store copied CCWs, and 
the remaining two entries (16 bytes) contain pointers and end-of-buffer indicators. 
The format and contents of a CCW copy block is shown in Figure 4.50. 
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VIRTUAL STORAGE 
USER PARTITION 



Original CCB 



Original- CCWs 



CCW1 



CCW2 



CCW3 



I/O Areas 



A(1st part) 



A(2nd part) 



page boundary 



REAL STORAGE 
SUPERVISOR 



Channel Queue Entry 



CHANNEL PROGRAM 
TRANSLATION 




a third 

CCW copy block 



I/O Areas 




*-A (1st part) 




-B 


A (2nd part) -^ 
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Figure 4.49. Illustrates the relationship between an original channel program in a 
virtual partition and the copy blocks required by the channel program 
translation routines. The input/output areas in real storage are also 
shown. 
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Field 



Legend: Square keys 
refer to the description 
below. 








1 


2 


3 


4 


5 


6 


7 





CCBCNT 


CCB 
COM1 


CCB 

COM2 


CCB 
STA1 


CCB 
STA2 


CCB 
CLS * 


CCB 

LNO 


8 


CCBCCW 

Address of first CCW 


CCBBY3 


CCBCSWW 


16 


CCBSENS 
Sense CCW if any 


24 


CCBPIK 
User PI K 


CCB 
FLAG ** 


Unused 


CCBVA 

Virtual Address of CCB 


32 


CCBACB 

Address of first CCW copy block in 

channel program 


CCBICB 

Address of first I DAL block in channel 

program 


40 


CCBXINF 


(Fix information; 24 bytes) 

Each bit in this field represents one page frame. 
If a bit is on, the associated page frame contains 
a page fixed for this I/O request. If more than 
384K of real storage are available, the address 
in CCBXPTR will point to any additional field 
which contains bits for the page frames beyond 384K. 




48 






56 






64 


CCBXPTR 

Address of additional Fix information 


CCBNEXT 

Address of next CCB copy block 



Set to X'21' (= copied CCB) 



Legend CCBFLAG: Bit 


1= Translation complete 


1 


1= Pages fixed 


2 


Not used 


3 


1= BTAM Second Time Request (I/O request from 




BTAM appendage) 


4 


Not used 


5 


Not used 


6 


Not used 



Description 



(16 bytes): Copied and updated CCB. 

(8 bytes): If a user sense CCW is available, the CCW will be copied into this area. If the sense I/O area crosses a page 
boundary, an IDAL will be generated and the address of the IDAL will replace the address in Sense CCW. 

(2 bytes): Contains the PIK-value of the virtual I/O requestor. This value will be used by the MOVECCB routine to 
identify the requestors CCBs. 

(4 bytes): Contains the virtual address of the original CCB. 

(4 bytes): Address of the first CCW copy block occupied by the real channel program. 

(4 bytes): Address of the first IDAL block of zero, if no IDAL is needed. 

(24 bytes = 128 bits): Contains the fix information for the I/O request (FIXINF). Each bit corresponds to a physical 
page frame. If a bit is one, the corresponding page is fixed for the current I/O request. The 128 bits are sufficient for 
a Relocate System with up to 384 K bytes of real storage. 

(4 bytes): If real storage is greater than 384 K, the FIXINF is logically continued in another copy block with 68 usable 
bytes corresponding to 1032K additional real memory. The address in H will point to the attached fix information 
field. For real storage not greater than 384K, the value of H will be zero. 

(4 bytes): Contains a chain pointer. All CCB copy blocks will be enqueued into a CCB Copy queue. CHAINPTR 
points to the next CCB copy block on the queue. If this copy block is the last one, CHAINPTR equals zero. The 
pointer ACCBB either will point to the first CCB copy block on this queue or is zero, if no CCB is copied. 



4.123 Figure 4.50. Explanation of the contents of a CCB copy block. 
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Channel Program without TIC or SEARCH Commands 

The CCWs in a channel program without TIC or SEARCH commands are copied 
into sequential locations in the CCW copy buffer. If the program has more than 
seven CCWs, a TIC is inserted in the eighth copying position and is made to point 
to the first CCW in the next copy buffer. CCWs 8 through 14 are then copied in 
the next copy buffer. If there are more than 14 CCWs, the process is repeated 
until all CCWs are copied. 

Refer to the DOS/VS Supervisor Logic manual for a full description of the CCW 
copy block when using TIC and SEARCH commands. 

Figure 4.51 (below) shows the copying of CCWs for a channel program requiring 
two CCW copy buffers. 
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VIRTUAL STORAGE 



REAL STORAGE 



o 



Virtual Channel Program 



CCBNAME CCB SYSxxx, CCW1 



Copied CCB (See Figure 4.50). 



CCW1 


CCW 


CCW2 


CCW 


CCW3 


CCW 


CCW4 


CCW 


CCW5 


CCW 


CCW6 


CCW 


CCW7 


CCW 


CCW8 


CCW 


CCW9 


CCW 


CCW10 


CCW 


CCW11 


CCW 




CCW Copy Block 1 
(See Figure 4.52) 



CCW Copy Block 2 
(See Figure 4.52) 



o 



Legend: TIC 



Transfer in channel command 



ACCW8 = Address of CCW8 
ANB = Address of next CCW Copy Block 
VB A = Virtual Address of CCW 1 (for Copy Block 1 ) and virtual 
address of CCW8 (for Copy Block 2). 

Figure 4.51. A channel program requiring a TIC to be inserted in copying. 
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16 
24 
32 
40 
48 

56 
64 






1st Copy location for CCW 



2nd Copy location for CCW 



3rd Copy location for CCW 



4th Copy location for CCW 



5th Copy location for CCW 



6th Copy location for CCW 



7th Copy location for CCW 



X'8CT 



X'88'*< 



X'000000' 



X'000000' 



Virtual address of first CCW in the 
Copy block 



Address of next CCW Copy block in 
the chain 



* X'80' indicates the end of the CCW copy locations in the block. It is replaced by a TIC 
(Transfer in Channel command) if the 7th copy location contains a copied CCW with data- 
or command chaining. Bytes 57-59 will then point to the copy location of the CCW 
following the CCW in the 7th copy location. 
Bytes 56-59 will not be changed if the CCW in the 7th copy location is a TIC. 

** X'88' indicates the last 8-byte entry in the block. It is replaced by a TIC if the CCW in the 
7th copy location is a status modifier CCW. For example a SEARCH command to a disk. 
Bytes 65-67 will then point to the copy location of the second CCW following the status 
modifier CCW. 

Figure 4.52. Format and contents of a CCW copy block 
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Translation Control Block 

The routine CCWTRANS is called by the channel scheduler whenever a channel 
program must be copied and translated. Since a page fault may occur during 
CCWTRANS, the routine and its subroutines are reenterable and can therefore 
process several translation requests concurrently. In order to make CCWTRANS 
reenterable a translation control block (TCB) is built for each task to serve as a 
dynamic work and save area. Each TCB is located behind the special save area for 
its task and has the format shown in Figure 4.53. 

How to locate: 

To locate the TCB (associated with the partition/task), add X'50' to the address of 
the System Save Area (displacement X'09' of the appropriate PIB). Labels 
CCWTCB1 - CCWTCBn identify the first byte of the appropriate TCB. 



Format 
of any TCB 

1 



8 



11 12 



15 



16 



19 20 



23 24 



27 



Flag 
byte 



used 

by 

BTAM 



TIK/PIK 



Pointer to 
Status Modifier 
List 



Pointer to 
Control Com'd 
List 



Pointer to 
TIC line 



Pointer to 
Copy Block 
End 



Address of 
copied CCB 
(for cancel) 



Number of 
free IDA words 
in IDAL block 



v*/ 



28 



47 48 



51 



52 



107 108 



111 



Work Areas 


Address of 
last TF IX 
request 


Save Area 
(Registers 2-F) 


Pointer to 
next used 
TCB 



Byte 0: 


bit = 1 


data chaining specified 




1 =1 


: Read/Sense command specified 




2 = 1 


: Read backward command specified 




3 = 1 


: Status modifier command with data chaining 




4 = 1 


: Status modifier command only 




5 


: Reserved 




6 


: Reserved 




7 


: Reserved 



Note: One TCB is generated for each partition supported. 

With asynchronous processing support, 15 TCBs are generated. 

Figure 4.53. Explanation of the contents of the TCB. 
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Fix Information Blocks 

In order to keep track of which page frames have been TFIXed for a request, a bit 
string is used which has a bit for at least every page frame up to the highest one 
which is TFIXed. If no page is TFIXed in an address higher than 384K, then the bit 
string in CCBXINF is sufficient (192 bits = 384K). Whenever a page is TFIXed, the 
bit corresponding to its page frame is set to one. If a page is used more than once 
by a request, it is TFIXed only once. 

If a page is TFIXed at a location beyond 384K, one or more additional bit strings 
must be added. This is done by enqueuing a copy block. Each copy block thus 
enqueued provides fix information for an additional 1088K of real storage. The 
additional blocks are queued with the first one being pointed to by the field 
CCBXPTR in the CCB copy block. Figure 4.54 shows how fix information is kept. 



"v_y 



Fix-String: 

bit-table where each bit belongs 
unequivocally to a page frame 
(for 1038K bytes); if a bit is on, 
the page frame belonging to this 
bit has been TFIXed for this 
l/O-request. 

ANB: 

—0 if Fix-block is last one in 

Fix-block queue. 

—address of next Fix-block. 



Fix-string 
of 544 bits 



+68 ANB 



Fix-bit string > 

represented 

page frame 



01 



■CCBXINF- 



OK 



TFix(1) 



Fix-string 1- 



384 K 



Fix-string 2- 



TFIX (2) 
384 K 
+1088K 



384 K 
+ 1088K 
+1088K 



• if for a specific page frame the Fix-bit is already on, noTFIX-request is transferred to the 
.page manager 

• the TFIX-b/ocks are freed after l/O-request has been posted complete 
F igure 4.54 Fix information Bit String and Block 
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General Rules for channel program translation 

The following rules apply to IBM -supplied channel program translation routine 

1. Channel program translation is skipped: 

• for I/O requests from programs running in real mode 

• for I/O requests from system tasks (FETCH/LOAD has its own small CCW- 
translation.) 

• for I/O requests for console when console buffering option is supported 

2. Channel program translation is modified for BTAM running in virtual mode 
(modify CCW-chain from I/O appendages). 

3. The following components work via copied and translated CCW chains: 

• CRT 

• seek separation routine 

• ERPs 

• BTAM-ERPs 

4. Channel program translation does not support: 

• self-modifying channel programs 

• start of I/O requests from I/O appendages for not translated channel programs 
(except BTAM) 

• time dependent I/O requests (channel program may get longer after translation) 

• channel programs with CCWs whose count is 32K 

• channel programs with data chaining in connection with TIC-commands when 
the same CCW gets different command codes during execution of channel 
program. 
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Byte 



PDAREA 



4 
8 
12 
16 
20 
24 
28 
32 
36 


PDAREAND 






PDINTRHK 






PDSIQHK 






PDTRANHK 






PDFLTHK1 






PDFLTHK2 










PDREGSAV 















Address of end of PD area 
Address of interrupt trace hook* 
Address of START I/O hook* 
Address of transient dump hook* 
Address of F/L trace hook 1 * 
Address of F/L trace hook 2* 
Reserved 

Save area for registers 9, 10, and 1 1 



*A hook is coding introduced at supervisor generation. The coding normally branches around 
itself. The initialization makes the branch instruction a NOP to allow a PDAID function to be 
performed. 

Figure A.l. The PD address table (Displacements are in decimal) 

Byte 






16 



24 



32 
40 



48 



Phase Name 



VER 



MCD 



IGN2/TRC2 
CUU 



Alternate 



Area 



Log 
,CUU 



IGN3/TRC3 
CUU 



End 



PRT1 



PRT2 



PRT4 



PRT5 



Reserved 



1 

Alternate Area Start 



1 

CHANC PTR 



1 

Reserved 



Reserved 



OPT 



1 

Register I© 



Displacement 


Label 


Description 


0-7 


Phase Name 


Phase being run 




8 


VER 


Version number in hex 




9 


MOD 


Modification level in hex 




10-11 


LOG 


Address of system log device 




12-13 


Output 


Address of output device 




14-15 


IGN1/TRC1 






16-17 


IGN2/TRC2 


Address(es) of devices to ignore or trace 




18-19 


IGN3/TRC3 






20-23 


Alternate 
Area Start 


Start address of alternate area 




24-27 


Alternate 
Area End 


Ending address of alternate area 




28-31 


CHANG PTR 


Address of channel queue pointer for output 
device 




32 


PTR1 






33 


PTR2 






34 


PTR 3 


Partitions to be ignored (see note) 




35 


PTR4 






36 


PTR 5 






37-50 


Reserved 






51 


OPT 


Option byte X'00' = TRC device 
X'80'= IGN device 




52-55 


Register 10 


Save area for register 10 (used by GSVC trace on 


iy) 



Note: The initializer inverts the logic. When the user specifies a partition(s) to be traced, PDAID 
enters the partition (s) to be ignored in the standard preface table. 

Figure A. 2. The PD Standard Preface Table (Displacements are in decimal) 
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PIK (Partition Identification Key) 

During debugging, it may be necessary to locate and to be able to interpret the PIK 
value allocated to each partition. 

The PIK of each partition is determined during system generation the PIK value 
being contained in a two byte field at displacement address X'2E' in the appropriate 
partition communication region. Byte of this location always contains X'OO', 
and byte 1 a hex number equal to the displacement from the start of the PIB to 
the start of the entry in the PIB belonging to the partition. 
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Foreground partition PIK 

The PIK value for foreground partitions depends on how many partitions are 
specified by NP ARTS parameter of SUPVR macro. 



PI K value at displacement address X'2E' of foreground COMR EGs, 
where byte = X'OO' and byte 1= ; 


NPARTS=5 


NPARTS=4 


NPARTS=3 


NPARTS=2 


PIK value indicated 


50 
40 
30 
20 


40 
30 
20 


30 
20 


20 


F1 
F2 
F3 
F4 



Note: The PIK values for foreground partitions do not change during system 
operation. 

Figure B.l. PIK Values 
Background partition PIK 

The PIK value for the BG partition is always X'10\ However, unlike the values in 
the foreground communication regions, the value held in this address changes during 
system operation. It always contains the PIK value of the active partition. 

Supervisor PIK 

A separate PIK value is given to the attention routine. The value is X'00', and 
indicates that the supervisor is in control. 



SYSLOG ID 

For PD output, values will be AR, BG, F4, F3, F2, or Fl , which identify the 
partition generating the trace entry. 
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TIK (Task Interrupt Key) 

The halfword TIK at displacement X'5 A' in the SCP Communications Region 
(SYSCOM) has a zero value in the high-order byte and a key value in the low-order 
byte. This key value is only significant when AP is supported. The key value in 
the TIK is the key of the program (task or subtask) that is being serviced. When an 
interruption occurs, the value of the TIK indicates to the supervisor which program 
(task or subtask) was interrupted. 

The TIK is set by Task Selection in the General Exit Routine and equals the index 
displacement of the task's Program Information Block (PIB) within the PIB Table. 

Depending on the number of partitions supported, the value of the TIK indicates 
which task was interrupted according to the following table: 



TIK Value 


Interrupted 


NPARTS=2 


NPARTS=3 


NPARTS=4 


NPARTS=5 


Task 


X'OO' 
X'10' 

X'20' 

X'30'- 

X'FO' 


X'OO' 
X'10' 

X'20' 

X'30' 

X'40' - 

X'FO' 


X'OO' 
X'10' 

X'20' 
X'30' 
X'40' 
X'50' - 
X'FO' 


X'OO' 
X'10' 
X'20' 
X'30' 
X'40' 
X'50' 
X'60' - 
X'FO' 


Attention 
BG 
F4 
F3 
F2 
F1 

Subtasks* 



*Asynchronous Processing option. The number of PIBs initially available for subtasks is 10, 1 1 , 
12, or 13, depending on the number of partitions (in an AP supervisor the total number of 
PIBs is always sixteen). 



LIK (Logical Transient Owner Identification Key) 

The halfword LIK at displacement 88 in the SCP Communications Region (SYSCOM) 
is only significant if AP is supported and contains the same value as the TIK when 
the logical Transient Area (LTA) is in use. LIK therefore, identifies the owner of 
the LTA. When the LTA is free, the halfword LIK contains zeros. The SVC 2 
routine sets the LIK, and the SVC 1 1 routine resets it to zero. If AP is not supported 
the LIK contains zeros. 



o 
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LTK (Logical Transient Key) 

The halfword LTK at displacement X'6E' in each partition's communications region 
has a zero value in the high-order byte and a key value in the low -order byte. 

In a foreground communications region, the key value in the LTK is not significant. 
The LTK in the background communications region (BGCOMREG) has the same 
value as the PIK of the partition of the task that owns the LTA, or contains zeros 
when the LTA is free. When the LTA is occupied by a task, therefore, the 
BGCOMREG has the same value in its LTK as in its PIK when the owning task is 
active. The SVC 2 routine sets the LTK, and the SVC 1 1 routine resets it to zero. 



Appendix B 

LTK. REQIDTKREQID 






REQID (I/O Requestor's Partition or System Task ID) 

The REQID is one-byte identifier in the Channel Queue (CHANQ) entry. 

When a background or foreground program has requested I/O, the REQID has the 
same value as the key byte of the PIK for that task's partition. When the Attention 
Task has requested I/O, the REQID contains X'OO'. 

When the request for I/O is from a System Task, the REQID has one of the 
following values: 

RAS -X'01' 

PMGR -X'02' 

SUPVR -X'03' 

CRT - X'04' 

ERP - X'05' 

PAGEIN-XW 

The REQID is set by the Channel Scheduler Routine. 
Note that X'OO' indicates that no system task is active. 
TKREQID (I/O Requestor's Task Identification) 

The TKREQID is a one-byte identifier in the Channel Queue (CHANQ) entry for 
a task that has requested I/O (see Figure 4.1 3). In an unused CHANQ entry the 
TKREQID contains X'FF'. 

The TKREQID byte in an active CHANQ entry has the same value as the key byte 
of the TIK of the task that has requested I/O. 

If AP is not supported it has the same value as the PIK of the task that requested 
the I/O. 

TKREQID is set by the Channel Scheduler Routine and reset by the I/O 
Interrupt Handler. 



^k||^F 
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Appendix C 

CONTROL REGISTER 
ALLOCATION 



Control 
Register 



10 



11 



12 



13 



14 



15 



SYSTEM CONTROL 


TRANSL. CONTROL 


EXTERNAL-INTERRUPTION MASKS 


SEGM-TBL LENGTH 


SEGMENT-TABLE-ORIGIN ADDRESS 




CHANNEL MASKS 














MONITOR MASKS 


PER EVENT MASKS 




PER GR ALTERATION MASKS 




PER STARTING ADDRESS 




PER ENDING ADDRESS 






ERROR-RECOVERY CONTROL & MASKS 






MCEL ADDRESS 



J 



Figure C.l. 
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The following two examples show the two different features of the ESERV program: 
that of de-editing without updating an edited macro definition, and that of de-editing 
and updating an edited macro definition. 

Sample Coding for De-editing without Updating a Macro Definition 



ESERV EXAMPLE 
JOB STREAMS 



//JOBNOUPDATE 
//EXEC ESERV 
PUNCH E.MAC1,MAC2 
/* 
/& 



(See note 1) 
(See note 2) 
(See note 3) 



Notes: 

1. Name of job is NO UPDA TE. 

2. Causes ESER V to de-edit the macro specified in the following PUNCH 
statement. 

3. Causes the macros MA CI and MAC2 to be punched out from the macro 
library (E) 

You could use the above coding to produce a de-edited source macro for possible 
future updates. 

Sample Coding for De-editing and Updating a Macro Definition 

The Procedure in the following exarnple produces a de-edited, updated macro 
definition in source format, and edits and places the update macro definition in 
the macro library, using the MAINT program. 






//JOB UPDATE 
// EXEC ESERV 

GENEND 



DSPCH E.MAC1 



) COL 77,4 
) VER 72+1,5 

.PP9 

) ADD 72+1 

AIF (&PCH NE 1400) D4 
) DEL 102,103 
) REP 245 

JOYCE CLC (4,REGG) ,BLANKS 
) END 
/* 

// PAUSE 

//OPTION EDECK,NODECK 
//EXEC ASSEMBLY 

(deck produced by ESERV 
goes here) 
/* 

// PAUSE 
//EXEC MAINT 

(deck produced by 
assembler goes here) 
/& 



Causes ESERV to de-edit the macro 
specified in the following DSPCH statement. 
Causes an END and /* statement to be 
generated. These are necessary to allow 
output from ESERV to be used immediately 
as input to assembler program. 
Causes the macro definition MAC1 to be 
punched and printed from the macro 
library (E). 

For explanation see: "Verifying/ 
Updating Statements from a Printout 
of Macro Definition". 



Check list, move deck to reader. 
Causes the assembler to produce an edited 
deck (EDECK): no object module 
will be produced (NODECK). 



Move SYSPCH deck to reader. 
Causes MAINT to put edited macro 
definition on macro library. 
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Appendix E 

PROGRAM EVENT 
RECORDING 



The purpose of the program-event -recording facility is to assist in debugging 
programs, for example, SDAIDS. It permits the program to monitor the following 
events: 

• Successful execution of a branch instruction within the 
designated virtual storage limit 

• Alteration of the contents of designated general registers 

• Fetching of an instruction from designated storage locations 

• Alteration of the contents of designated storage locations 



/ r ~\ 



The information for controlling program-event -recording resides in control 
registers 9, 10, and 1 1 , and consists of the following fields: 

Control register 9: 



EVENT M. 




GR ALTERATION 


M. 


8 16 
Control register 10 (X'A'): 


31 




STARTING ADDRESS 


8 
Control register 1 1 (X'B'): 


31 




ENDING ADDRESS 



8 31 

PER Event Mask: Bits 0-7 of control register 9 specify which events are monitored. 

The bits are assigned as follows: 

Bit 0: Successful Branching 

Bit 1 : Instruction Fetching 

Bit 2: Storage Alteration 

Bit 3: General-Register Alteration 

Bit 4: Unassigned 

Bit 5: Unassigned 

Bit 6: Unassigned 

Bit 7: Unassigned 

Bits 0-3, when ones, specify that the corresponding events are monitored. When a 

bit is zero, the event is not monitored. 



A. 
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Appendix E 

The monitor call instruction provides the capability for passing control to a MONITOR CALL 

monitoring program such as the IBM supplied SDAID trace routines, when selected 
indicators are reached in the monitored program. The indicators are MONITOR CALL 
instructions implanted in the monitored program. When executed, these instructions 
cause a program interruption for monitoring to take place, provided that an inter- 
ruption is allowed for the monitor class specified by the instruction. Along with the 
interruption, the monitor class number and a monitor code are stored for subsequent 
use by the monitoring program. 

The instruction MONITOR CALL designates one of 16 monitoring classes together 
with a set of 16 monitor masks in a control register. One mask bit is associated 
with each class. The execution of the instruction causes a program interruption 
when the monitor-mask bit for the class specified in the instruction is one. The 
cause of the interruption is identified by setting bit 9 of the interruption code to 
one, and by the information placed at locations 148-149 and 156-159 of low 
address storage. 

The monitor-mask bits are in bit positions 16-31 of control register 8. 





MONITOR MASKS 



16 31 



The mask bits, in ascending order of bit positions, correspond to monitor classes 
0-15. Any number of monitor-mask bits may be on at any time; together they 
specify the classes of monitor events that are monitored at that time. The mask 
bits are initialized to zero. 
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LINE MODE TABLE 



This table is built at supervisor generation time when the TP=BTAM, or QTAM 
parameter is included in the SUPVR macro, and MODEL=l 1 5 or 125 . An entry 
is built for each device for which the DVGEN macro includes the MODE=X'ssss' 
or X'ssssss' parameter. Each entry contains the actual mode setting for the device. 



MODTAB 



Number 

of 

start /stop 

lines 



Maximum 



Number 
of 

BSC 
lines 



Maximum 







Actual < 



Actual <^ 



r< 



A 



The first 4 bytes of the table 

Maximum number of start/stop lines. Sej: by the IOTAB 
macro at system generation 

Maximum number of BSC lines. Set by the IOTAB macro 
at system generation 

Actual number of start/stop lines. Determined by DVCGEN 
macros at system generation and ADD commands at IPL 

Actual number of BSC lines. Determined by DVCGEN macro 
at system generation and ADD commands at IPL 



not used 



Line Mode settings for 
Models 11 5 and 125 Comm. Adapter 






V 



Bytes 140-143 (X'8C'-X'8F') of the System Communication Region (SYSCOM) 
contain the address of the table. 

Label MODTAB identifies the first byte of the table 



Figure F. 1 . Line Mode Table (LMT) 



c 
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This appendix shows an example of the output obtained from a formatted stand- 
alone dump as generated by the IBM program DUMPGEN with the parameters 
FORMAT=YES and PPOOL=NO. 

Refer to Section 2-A-3 for a description of DUMPGEN and the stand-alone dump 
program. 

In a system dump output, the supervisor area dumped is almost identical to that 
dumped by the formatted stand-alone dump, the only difference being that a 
system dump does not divide the dump into blocks of 2K storage areas. Refer 
to Section 2-A-2 for a description of the system dump. 

The programmer's remarks on the dump example indicate how the various tables 
and information blocks are located by using addresses stored in the communication 
regions. The programmer has also indicated the meaning of several bytes on the 
dump, enabling a mental picture to be built up of the system status just before 
the dump program was executed. 

Following the last but one 2K block of real storage (246 in the example shown), 
the page status information and contents of the control registers is printed. In 
the example shown of a formatted dump, the control registers are followed by the 
communication regions. (This does not include the system communication region.) 

The remaining part of the example shows the order and format of the tables and 
information blocks printed in a formatted dump output. 

The last block to be printed is the SELECTION POOL, the contents of which are 
explained in a note at the end of the example. 

IMPORTANT NOTE 

The location and addresses of the table and information blocks shown in this 
example apply only to the system that produced this example. The actual location 
of areas indicated depends on the system generation options specified, and the 
program running in your system just before the dump program is executed. 



Appendix G 

EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 







Figured part 1 of 20 
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EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 



pmn 



wmmmm 



La.tf 



0786CP 
07B6E0 
07B700 
07B72 
0767*0 
07B760 
07B78O 
j407B7A0 
07B7C0 
07871:0 



F2*1C6E* 05C3F3C9 06')5*0l)5 .)6E3*0C5 E7C5C3E* E3C5C*66 *0C3D9*O C905*0C9 

05C9F3C9 C103*0F2 t3ClE3F* E2C1C*C* D9C5L2E? C5!:?*~C6 D6I)9*0E2 C5C70*C5 

:J5F.3*0E3 C1C203C5 *0C9:}5*(. CS09Fl*0 C105C**0 h2E<U2C3 06I)**0C* 06*00506 

E3*00*C1 C3C3C8C3 J9F 1*0C 3 06051: 3C5 05E 3E2*0 C9E2*OU3 C102C5D5 *1E306*C 

03O6C3C1 E3C5*0E3 C8C5*0E2 C5f.n*C5 05E3*0E3 C1C2D3C5 C90lC2t2 C5C7F3*0 

C3J6J5E3 C505E3E2 *1C9E2*0 F3C102C5 05*OF3!)6 *00 3D6C3 C1E3C5*0 F3C8C5*0 

F.'C5C7UA C505E3*0 t 3C IC 2D 3 C5E2C5C7 D*C505E3 *0E3C1C2 0305*003 C1D505D6 



«<7jKt - 



BLOCK OQ 






A 



'(TOOOOOO 
0000000 




000000 
00002" 
0000*0 
000060 
000080 
OOOOAC 

joooco 

000*A0 
000*CP 
. 000*EO 
,J)" 000500 
C.Y > 00052O 
^0005*0 
000560 
000590 
0005AO 
0005C0 
0005E0 
000600 
000620 



0006C0 
0006EO 
000700 
0007*0 
000760 
000780 
0007AO 
0007CO 
0007E0 



000800 
000820 
0008*0 
000860 
000880 
0008AO 
0008CO 
0008EO 
000900 
000920 



|0900A619 ?00000*F onoonooo 0O000JOO 
i07*000n0 1(-P89B62 O00C2OOO Q-)O0A6*8 



3007)038 08C 



OC00 0C07H0 30| 00003000 
* PC .3'QIQ 0O00ORCC 0C0C000O O0O0A5FO 
00^015*0)0000^000 0P"2C007 000*0005 



0007BQ00 1PQPE2AS| *B*B*B*h\ *B*6*B*B 

00OO0000 "0000000 070F2O0 n |0O00O90C 

F*0C8900 02OAFL5D (.0180000 1000A67E 

O00C0CPO 0007B3AA COOSOC f ■(. 0000 A67E 

*009.J8*0 00020000 0O00riOOOtf.QTr 00 ICC 



296 |*297fr 389 3FPQ3F06 )3FOCl 3 



00000100 6010C 



*6300000 3f)CC3E*C 3E8C001.) ' UpfiffT^ 
01001010 C*A01PC0 000005 83 C3C00 ' - K 

oodo6i*3 mwxi\ flafl*;i7Cfl pmoii^j 



00017000 1 2lQO50E6 | 0032002C [POO 

60 800800roOO^)SFC g. 1/ , 

0000001 \P TOO 7 99S - - "<*'**** °f 

O000A5E2 loiS^mO C W^<J 

0118 10 18 I002000CO OOOOCOC' 
0)000000 
00006308, 

7 



SSbOOQO I F3L)60*E2 C*0*C7*0 
F OTFTrrpV-ttL AOC E 00 002E*OFD 

"'/ 7/^"""-^ oooqico*) 00^00 30 

HdoUeVi 0/ X j.'i.000 386* J J3rtO*p A30 

/>/»; r*o*o*o*<" *o*o*rfo"o 

;o « u \-')J*hV» uut ' ijbm* niiuiiyJLy 1 

C0O00 00O08299 00006088 
0000(0*1 0)007*60 



DCa 00 



DO . J0OC070C 

/la&&£*<> cf Cfum AaK9^ 0~000*2*6| 00000760 
Aobkwi cjt A/>?o<v'/VSf — ^0 00003A8C OCOOOOOC 



52 OO^OOOCO O'mjOOOOO 



O0O0O0 O000OO0C [01*l|0003l jO0C0E6*QI]O0 V)DE B8| 0000F2BC I0C006378 

000000 ( _ ) ')C c ^' l ''2<r:?!!? -_v rooo° 49 20f*oc7ciooo ] oooino*3 oi*5coco 






ta/l 

00000000 00000000 07F608*C OOuuuuuu 

0002O0O8 00020*06 080A0COE 001830*8 

0083C083 — SAMt — 

00830083 83838300 00000000 0OO0CO0O 

0030*036 00009260 O0C00OO0 00000000 

00003EF0 001OO0O0 OOC07118 00OO71D0 

00000000 00000680 06B006B0 06B006B0 

06B006B0 06B0O6B0 06B006BO 06B006BO 

95030585 *7700826 *59008C2 *7F00326 



PACE 
\ TfiBL e 

ndckm of 






- . . 3'JOU '.)'. 

00000002 O0OUUOO3 

00C07288 000073*0 

O6B0*BB0 O6E206B0 

06B006B0 06B0*1BB 001F*1BB 0010181 

06B006B0 06B006B0 06B006B0 06B006B0 



CPU. ID 



Z Mt 2K IJLU </ a£^z 



*1BB001F 
937E9*63 
07FF960C 
*16008FC 
O6B006B0 
30020787 
07F7*880 
072F9*FE 
9500060F 
091D9000 



06RO06H0 
3006*260 
A00FAF01 
07FF06B0 
06B006BO 
18*1*3*0 
0*CE8R80 
058207F9 
*7800A5A 
D01*0919 



*IBB001B 
A00158B0 
01AE**00 
06B006BO 
06B0AF05 
300209*0 
0003*188 
*590C6C2 
AD03D99C 
06C 0*780 



*5700896 
065C960C 
B97A077F 
068006BO 
010O50B0 
00035A*0 
0038*188 
9283A000 
95000585 
09061BAA 



5890055* 
AO0FAFO1 
9200050F 
06B006BO 
00C08200 
056*19A1 
06C0928 3 
5880A00* 
*7700AA* 
50A0050C 



*1K092** 
01AE9510 
928 307*1 
06600660 
06581611 
*3AC/*007 
80009200 
50008030 
02100910 
ACFCU99C 



1211*770 

A001078F 
92000599 
06B0C66C' 
03000680 
*AA00*FA 
0585920* 
92008030 
0932*890 
*3A10015 






I 01000000 



Lou)- adcUev* /uofoxiB, 




Actobm */ ul '.'.".'.'.'.'.'.WW's 

#•*. &$#■ -.:..;:.;.;.:*'. 

°f -^ruf 



0826*IF0 
AF050021 
*560B81* 
06B006B0 
300*95FF 
5810*000 
06899283 
92000689 
0*FA0C10 
*2A00585 



£k lo/ Kr. 



( 



"A. 
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Appendix G 

EXAMPLE OF A 
STAND ALONE 
DUMP OUTPUT 







oo: A<44e*> °f 
oo £<f *t**tttp-yi 
003BCO oooooool 



f/BZ &&y*y £ Sf 



003BEO 
003COO 
003C20 
003C40 
003CC0 
O03CE0 
003000 
003D20 
003D40 
003060 

rV 003DA0 



60000004 0800E7E8 0OO0OAO1 
C2C4E4D4 D7401700 000070AO 
00000000 00000000 00000000 

__^ J.04A00000 0002000B 00000000 

O00O0OOC mp4Aq pOOO 00020007_ 00000000 0010000_oT45900036 00020007 00000000 
00200000 44Tf'00"0"6"2~ "O~0~o6666o" OOOOOOOO" " "o"030"0"o"ob"4450008E 00020007 00000000 
00400000 I 43BOO0BA 00000000 00000000 




00500000 oooooooo oooooooo_floo«o«ee- 



00000000 — SAME — 

oooooooo oooooooo oooooooo oooooooo 



000E2880 8200C2C7 80040000 00006458 
80441E80 8000C6F3 80007800 00006508 
009C1E80 8000C6F1 80008800 00006758 



OOOOOOOO I 8OO0 fclD9j OO0OOOOO 000063E8 



OOOOOOOO 80000000 OOOOOOOO 000068D8 

OOOOOO OO 80000000 OOOOOOOO 00006A58 

OTToTJTJTOO- «QO00000 OOOOOOOO 00006B08 

OOOOOOOO 8000>QpO OOOOOOOO 00006D58 

OOOOOOOO 800000CO OOOOOOOO 00006E08 



O00E288O 8200C6F4 80061000 00006518 
00701EOO 8300C6F2 80089000 00006698 

oor.BiFonl flOoooooo onnoonoo onnn6aiB 



OOOOOOOO 80000000 OOOOOOOO 00006998 
OOOOOOOO 80000000 OOOOOOOO 00006B18 
OOOOOOOO 80000000 OOOOOOOO 00006C98 
OOOOOOOO 80000000 OOOOOOOO 000Q6E1B 

ooooooooi oooooooo oooooooo oooooooo 




AP 5u/6U f/0s 

At//* L(/B /^Jr £/& /J «; ft,Q 

'■ — * — ^ ., 



904100 
004120 
004140 
004160 
004180 
0041A0 
0041C0 



6201 jZ'gt/ooe. */ 

6,05 U6™ 
ooof 



50C3 
50C3 



666660 




; H!OUoCFKJO 
-Awce fat, * Putv&r K<*fS***>t °"oo 

*<?*w 6 mm e^y, * ic 03 -i;;n 

C0|FF0OOOO0 



620002F8 
620402F8 
50C300C0 
50C302C0 



OOOEFFOO 
0131FFO0 
0260FFOO 
02A2FF0O 
15 38 IF FOP 



\ 004240 
/004260 
004280 
0042A0 
0042C0 
0042E0 
004300 
004320 
004340 
004360 
004380 
0043A0 
0043C0 
0043EO 
004400 
004420 
004440 
004460 
004480 
0044A0 
0044C0 
0044E0 
004500 
004520 
004540 
004560 
004580 
0045AO 
0045CO 
0045E0 
004600 
004620 
004640 
004660 
004680 
0046A0 
0046C0 
0046E0 
004700 
004720 
004740 
004760 
004780 
0047A0 
0047C0 
0047E0 



OOOOOOOO FFOOOOOO 

OOOOOOOB 
00080000 

oooooooo 



1428FF0B 
OOOOOBOO 
00001300 
00001800 
00002300 
00002B00 
00003300 
00003BOO 
OOFFOOOO 



6628FF00 
OOOOOOOO 
00001500 
00001DOO 
00002500 
00002000 
00003500 
06FF0000 



0O0OOA67 
OOOOOEOO 
00001600 
OOOOIEOO 
00002600 
00002E00 
00003600 
OOOOOOFF 



OOOOOOOO 
OOOBFFFF 
F2F0F6F7 
0000806C 
40404040 



OOOOOOOO 
FD7FCED3 
F3F3F4F0 
000073F8 
40404000 



05064005 
0OO0CE5O 
00003CD4 
00003864 
40404040 



C1D4C540 
002E40FD 
0000003C 
3BD45A30 
40404000 



J F1F261F0 
OOOOOOOO 
41044296 
48100000 
OOOOOOOO 



9C28FF15 

00001000 
00001800 
00002000 
00002800 
00003000 
00003800 
OOFFOOOO 



9C2 8FF15 
00001100 
00001900 
00002100 
00002900 
00003100 
00003900 
OOOOOOFF 



*--*\ ,. 1 . . . s 

~ 3 ~ . • 1Z 
■66 381 



tn ~7/B - & 



TIB 



oooooooo 

OOOBFFFF 
F2F0F6F7 
00008075 
40404040 



OOOOOOOO 
FD7FCE03 
F3F3F4F0 
00007340 
40404000 



C3C1D3C3 
30804E00 
00003C04 
00003864 
40404040 



OOOOOOOO 
OOOBFFFF 
F2F0F6F7 
0000807E 
40404040 



OOOOOOOO 
FD7FCE03 
F3F3F4F0 
00007288 
40404000 



D50640D5 
OO0OCE50 
00003C04 
00003864 
40404040 



E2C90440 
002E40FD 
0000003C 
3B045A30 
40404000 



J F1F261F0 
000A1FFF 
41044296 
47980000 
OOOOOOOO 



F661F7F3 
OOOOOOOO 
42974389 
3DCC3E4C 
04A010E0 



OOOOOOOO 
OOOBFFFF 
F2F0F6F7 
00008087 
40404040 



OOOOOOOO 
FD7FCED3 
F3F3F4F0 
000071D0 
40404000 



D2C5d5e2 

3000CE02 
00003CD4 
00003864 
40404040 



C1D4C540 
002E40FD 
0000003C 
3B045A30 
40404000 



J F1F261F0 
OOOOOOOO 
41044296 
47200000 
OOOOOOOO 



TSTTTTfT 

0008 AFF6 
42974389 
3DCC3E4C 
04A010EO 



70007000 
OOOOOOOO 
3F003F06 
3EBC0010 
00000588 



76667666 

0008D40F 
3F003F06 
3EBC0010 
00000588 



OOOOOOOO 
00000050 
3F0C38F1 
00000050 
C0CQO040 



J F1F261F0 
00074FFF 
41044296 
46A80000 
OOOOOOOO 



F661F7F3 
OOOOOOOO 
42974389 
3DCC3E4C 
04A010E0 



70007000 
OOOOOOOO 
3F003F06 
3EBC0010 
00000588 



OOOOOOOO 
00000040 
3F0C38F1 
00000040 
C0C0QO4O 



OOOOOOOO 
OOOOOOOO 
00790000 
00000019 

oooooooo 

00510000 
00000013 

oooooooo 

00500000 
00000019 

oooooooo 

FFOOOOOO 
00000019 
OOOOOOOO 



oooooooo 

00510000 
00000013 

oooooooo 

00500000 
00000019 

oooooooo 

FFOOOOOO 
00000019 

oooooooo 

00500000 

oooooooo 
oooooooo 

00790000 



oooooooo 
oooooooo 

03E 80000 
OOOOOOFF 

oooooooo 

03E 80000 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 

oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 



66666666 

00500000 
00000019 

oooooooo 

FFOOOOOO 
00000019 

oooooooo 

00500000 

oooooooo 
oooooooo 

00790000 
00000019 

oooooooo 

00510000 
00000013 



F661F7F3 
00063C5B 
42974389 
30CC3E4C 
04A010EO 



70007000 
OOOOOOOO 
3F003F06 
3EBC0010 
00000588 



OOOOOOOO 
00000030 
3F0C38F1 
00000030 
COC00040 



2FA66666 

00000019 

oooooooo 

00500000 

oooooooo 
oooooooo 

00790000 
00000019 

oooooooo 

00510000 
00000013 

oooooooo 

00500000 
00000019 

oooooooo 



oooooooo 

00000020 
3F0C38F1 
00000020 
C0C0OO4O 




C-A (KENSLOOjy / 

1 ' l\..K.. T 



BLOCK 009 

004800 00500000 OOOOOOOO 00000019 OOOOOOOO OOOOOOOO OOOOOOFF FFOOOOOO OOOOOOOO 



'(gK/ozta) 
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Appendix G 

EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 



005080 
0050AO 
0050C0 
0050E0 
005E00 
005E20 
005E40 
005E60 
005E80 
005EA0 
005EC0 
005EEO 
005F00 
005F20 
005F40 
O05F60 
005F80 
005FA0 
005FCO 
005FEO 



S1646 
00454780 
96207003 
90001000 
O0*0E23C 



E4724B60 06E25060 00484166 0008D300 
92036000 47F0E386 D207E23C 0040D203 
4720.E56C 4710E472 91020044 4710E472 



7798203A 

E680203A 

0000FF0 

OOOOFFBO 

OOOOF/00 

OOOOfFOO 

OOOOfFOO 

OOOOKFOO 

OOOOF 

OOOOFFOl 

OOOOFFOO 

OOOOFFOO 




io6 76C8209A 6AFF6866 

000 



0000 OOOOFFOO FFFFOEOO 0000FFT3 



766fl2]03A 
7730203A 
-ZS6&203A 



0048E215 
0048E230 
5060fla*tf' 



entry, 00 urn* oia&(&cc £r 
"CCS <xMr*v> - FfOV' 

FFFF3100 OOOOFFOO FFFFFFOO OOOOFFOO 



66666666 62666666 66666666 66666600 03000000 

00000000 00000000 05000000 00000000 00000000 

07000000 00000000 00000000 08000000 00000000 

00000000 OAOOOOOO 00000000 00000000 OBOOOOOO 



Wl 

04FF0B00 

04FF0900 

FFFFOFOO 

: FF1300 

: FF1700 

: FF1B00 

: FF1FOO 

FFFF2300 

FFFF2700 

"FF2B00 

-F F2F0O 

FFFH 0014 

00000000 

06000000 

00000000 

00000000 



96407000 
03000048 



47F0E386 

yiooiuuu- 

E2150207 



39A0033C 
78D0203A 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 



7FFK )5o6" 
06FFFF0O 
04FF0C00 
FFFF1000 
FFFF1400 
FFFF1800 
FFFF1C00 
FFFF2000 
FFFF2400 
FFFF2800 
FFFF2C00 
FFFF3000 



61066060 
00000000 
00000000 
09000000 
00000000 



00000000 
04000000 
00000000 
00000000 

ocoooooo 



CHRNQ 



..L...S 0T. 

. K...S....6.... 

_ -II. C I *„*_ 

OZ , ukceJi. en cAcurtjeef j 
Gf 3 -# OS-* 00 -*o/ 
-*■ 0%-* 04-* of-*ot 
-* 03 -> O C > Ff 



BLOCK 012 



006000 
006020 
006040 
006060 
006080 
0060A0 
0060CO 
006OE0 
006140 
006160 
006300 
006320 
006340 
006360 
006380 
0063A0 
006 3C0 
0063E0 
006400 
006420 
006440 



00000000 OOOOOOOO 00000000 
OFOOOOOO OOOOOOOO OOOOOOOO 
OOOOOJ 
■7KX*H#- 






1000000 
IO0FF00 
1000000 



OOOOOOOO 
10000000 
flWtOUUUCT 
OOOOFFOO 
FFOOOOOO 
OOOOOOFF 
OOOOOOOO 



-$£//£?A3 



OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
007A0013 
OOOOOOOO 



— SAME— 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 



1000E600 
OOOOOOOO 
00200040 
OOOOOOOO 



OAOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 



OOOOOOOO OEOOOOOO OOOOOOOO OOOOOOOO 
OOOOOOOO OOOOOOOO 1 1000000 OOOOOOOO 
13000000 OOOOOOOO TTDOeOODO FFOOOOOO 
000000"~»O£,F0000 
OOOOFF 000 
s* ^«t/* <y G/(/1.Kj{ 000000 200020tf 
( 000000 OOOOOOOO 

11 

410C0400 OOOOOOOO O00OE7E8 10000000 
OOOOOOOO 4000E9CO OE000005 00000400 
OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 

oooooooo loooooo66] 6663B866 66656626 



I5B5BCJC2 C569B9CII 4BCHA4C 68662F.6C 166666066 66666600 06600000 00000000 



00040000 OOOCOOOO 00017000 0001E800 00040000 00061000 0001E800 00021000 
00061000 00075000 00021000 00023800 00075000 00089000 00023800 00027000 
00089000 O0OA2O00 00027000 0002A800 000A2000 OOOCOOOO 1 01310000 OOOOOE10 



00000E74 
000086BB 
00089000 
OOOOOOOO 



6166FIF1 

000084BA 
FFFF7D18 
— SAME— 



F 1F1 F 1 F 1 

00008534 
00008340 



6666C45C 

8000837A 
00008660 



070D1000 00008460 000085D8 000084CA 
000082E8 00008318 00008308 00089040 
00004450 OOOOOOOO OOOOOOOO OOOOOOOO 









y 




yrrt f 



of 



009 3C0 
0093E0 

coa'ioe- 



pboW 



009480 
O094A0 
0094C0 
0094EO 
009500 
009520 
009540 
C09560 
009580 
0095AO 
0095CO 
009 5E0 
009600 
C09620 
009640 
009660 
009680 
009 7E0 



F2F3F4F5 F6F7F8FO r,r ? r J r A r *'"'"'" Vnt, nc "3C5D3 C9C7D506 , 

40404500 C10940' fuel Hcufafa Of "* <l/*<t 50000 OOOOOOOO /font, Of (KUZk. PfiH/P 

00000898 " MC - . v i. , f 

OOOOOOOO OOOOOO00 lOOOg99FFj| O00O479C 0000168E OO00B44EV 0Q000C 56 00009F02 
00001000 



'456789ABC0EFCA NCELIGNORE 



30 ^ 107:401 



00000330 03004798 0030- 

FFFFFFFF |00030800||Q003FFFOl 3 FOE 
FFFF 

4 740? 
0003 

i™/^ .*»* 

020193 (A 'jiuA-yusf Vl<!0^(5^^ VUJC 

1B651876 1B665D60 910C4C70 910E 

98579120 47F091CC 41509120 5869 

9C6CAO00 OOOOOOOO OOOOOOOO 0000 
00003330 — SAME — 

OCOOOOOO OOOOOOOO OOOOOOOO 0000 



C9 C4C 
■f FF 



t^J^y *Z£ ? if? 



000000 /Y&M*. Of CbCCCtK. 

00B44E/ 0Q000C56 00009F 
C7E3EM TFrF3009 FF ct: FFI 
FFFFFF FFFFFFFF 0003FF 



FO 
OB 58CO0080 9500C045 
5FF 910B078A 95FF910B 
83 S3C4D500 80030083 
70 91180207 70000020 90017008 
31 70108002 41770012 5970911C 
10 00000001 OOOOOOOO 00030800 
!0 90839049 02009089 904A0200 
: 909F47F0 917090CA 91809058 
iD 928090C7 95009070 4770917E 
iO 903:5860 90433203 905*9040 
15 50509114 50509118 5070911C 
047F3 
0000 



fa^f ft* Pf*+e«" 



|P0AI3GTw} . 






JO oooooooo oooooooo oooooooo 



Figure G.l part 4 of 20 

AJ4 Appendixes. 



Appendix G 



o 



EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 






S& 



00DE40 
000E60 
000E80 
OOOEAO 
OOOECO 
O0DEE0 
0ODFO0 
00DF20 
00DF40 
00DF60 
OODF80 
OODFAO 
OOOFCO 
OODFEO 



F01O9200 
OOOOOOOO 
00000000 



F7485870 
— SAME — 
OOOOOOOO 



00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 



00030000 
00070000 
00080000 
OOOFOOOO 
00130000 
00170000 
00180000 
OOIFOOOO 
00230000 
00270000 
0O2B0000 



00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 



OOim^-Nl Q0020000 

60040000 00026660 



000000*0 OOQ00OO0 OOOOOOOO 



IOCWO OOQi 

rjPkqc 7 



..7...6U.7. .6H .7. 



00080000 

ooocoooo 

00100000 
00140000 
00180000 
OOICOOOO 
00200000 
00240000 
00280000 
002C0000 



00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
'00020000 



(&00JJ0000 

"00050066 

00090000 
OOOOOOOO 
00110000 
00150000 
00190000 
OOIDOOOO 
00210000 
00250000 
0029 0000 

JJoTSoooo 



T00020000 

00020000 
00020000 
00020000 
00020000 
00020000 
00020000 

00020000 

00020000 

00020000 

00020000 

' 000001EO 



BLOCK 028 



//7f<r /%/?/*£ 7j0ce- 



OOEOOO 
00E020 
00E040 
00E060 
00E080 
OOEOAO 
OOEOCO 
OOEOEO 
00E100 
O0E120 
00E140 
00E160 
00E180 
00E1A0 
00E1C0 
OOEIEO 
OOE200 
00E220 
00E240 
0OE260 
0OE280 
00E2A0 
00E2C0 
00E320 
00E340 
00E360 
00E380 
00E3A0 
00E3C0 
O0E3EO 
00E420 
00E440 
00E4A0 
00E4C0 
0OE4EO 
00E500 
00E520 
O0E540 
0OE560 
00E580 
OOE5A0 
00E5C0 

I 00E640 
'00E660 
00E680 
00E6A0 
00E6C0 
00E6E0 
OOE700 
00E720 
00E740 
00E760 
00E78O 
00E7A0 
00E7C0 
00E7E0 



002201F8 
000002AO 
000001CO 
00000100 
00000200 
OOOOOIBO 
00000410 
00000298 
00000280 
00000220 



00820268 
00810268 
00C70418 
OOC40208 
013901FO 
013102B0 
01130290 
01160230 
01300270 
0UA0258 



00220260 
00000210 
000001A8 
OOOOOIAO 
00000228 
00000248 
00000188 
00000270 
00000288 
00000190 



00830410 
FFFF01E0 
00C601B8 
FFFF0170 
013A01F8 
01190298 
01170248 
013F0410 
01410278 
00C80198 



•X'2fc'=f S 

00000208 00840240! 
00000250 OOC5O1C0 
002202AO 00C20190 
00000268 013701B0 
00000108 00800188 
00000290 01120200 
00000240 01180220 
00000198 013501E8 
000002A8 01400280 
000002BO 01420288 



oooooifo 
00666 ie's" 

00000418 
000001F8 
000002B8 
00000258 
00000230 
000C0278 
00000238 
00000218 



00020000 
00060000 
OOOAOOOO 
OOOEOOOO 

00120000 

00160000 
OOIAOOOO 
001EOOOO 

00220000 

00260000 
O02A0OOO 
FFFF0400 



013B02AO. 
O"l36'02i8 
OOC301D8 
01380190 
FFFF01AO 
01150250 
011401A8 
013E0260 
O13C0228 
O14302A8 



000002C0 FFFF0210 
000002E0 FFFF02D0 
00000300 FFFFC 
00000320 FFFFC 
00000340 FFFFC 
00000360 FFFFC 
00000380 FFFFC 
000003A0 FFFF0390 
000003C0 FFFF03B0 



00 



000003A8 FFFF0398 
000003C8 FFFF03B8 



0O00O2D0 FFFF02C0 000002D8 FFFF02C8 
000002FO FFFF02E0 000002F8 FFFF02E8 
00 00000318 FFFF0308 
00000338 FFFF0328 
00000358 FFFF0348 
60 00000378 FFFF0368 
80 00000398 FFFF0388 
000003BO FFFF03A0 000003B8 FFFF03A8 
00000300 FFFF03C0 00000400 FFFF03C8 



000303E0 
00030400 

66500168 ' 



0O7B03D0 O003O3E8 007C03D0 000303F0 007D03D0 000303F8 007E03DO 



OOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 



00000000 

OOOOOOOO 



— SAME — 

OOOOOOOO OOOOOOOO OOOOOOOO 



00400048 
00C000C8 
01400148 



00500058 00600068 00700078^ 
00D000D8 O0E00OE8 OOFOOQFB 



100001 0008 00100018 00200028 00300038 



80 1 ISO 1 1 

PflQ£ 

80018001 

00150015 

00150015 

02A10025 

00250025 

00250025 

00350035 

00350035 

02490221 

00450045/ 

01F101F/ 

005500,05, 

0055QJ 



01500158 016001681 801>tf011 

smiaon 80H8021 80218021 

TABLET V60518051 



00800088 00900098 OOAO0OA8 OOBO0OB8 
01000108 01100118 01200128 01300138 



20800 moo i79oo 18000 moo 



800103D9 03E 

— SAME-- 

00150015 Bt)150015 00150015 

0025002^00250025 00250025 

-SAM 
0035,0*035 00350035 00350035 
iME — 

0035 
D045 

7<i/a. 3261 



3E9 03F103F9 |0209pl99 | 0179|01 81 1 0189| 0015 00150015 



f\cwetf> °^ 



"00150015 01C901D1 01D901A9 01C101B9 
00250025 00250025 00250025 00250025 



00350035 00350035 00350035 00350035 



00350035 02290239 02510231 02590241 



-FfFF en Jf& 4*-<^/S 



* S fra*"*! c*i&o/ dp. P/D/9/6 



crv«>f: 



1 J&&cM*i4< 



, 00 oooooooy 00000000 oooooooo 

f606e370 rflflOESBO F666HF6 F6(fr JE430 JFOoag475 fOOOe^bo foooeVoI "1 
F000E570 foqoe5b6 F0Q0E5F0 I flflflocrettt 66666661 6OO6O661 00000001 j bcirneNT 
TABLE 



UU55UU55 0U550U55 00550055 



iflflflOO 00002004 OOOOgflSO 000&l!ii8 

000OE830 OOOOOOOO OOOOOOOO OOOOOOOO 

OOOOOOOO 00OOE908 0702301C 60000006 

06023D50 600000AO 92023D38 20000005 

80000000 ., 000B9CE0 88000000 0000E998 



OOOOOOOO OOOOOOOO 0020COOO 000614E8 
OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
3102301E 60000005 0800E600 OOOOOOOO 
OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
69013074 66666620 09018094 20000025 



-•>- 5l _ « __ /fvoo 
-"- *L7 _ . — /7Vbo 
-■<- *f% - „ — /%ooO 

-«■-£?_„- /8r?O0 



100000000 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
00008000 
OO00E6C8 
OOOOOOOO 



— SAME — 

OOOOOOOO 80000000 00041770 



ccw copy block 



88C00000 









-Aolcdwb y -n&c/ CcW co/°y /icoc-K jit <2£, z/o <j6v*^£>n 



BLOCK 

00E800 
O0E820 
00E840 
00E860 
OOE880 
00E8A0 
00E8C0 
00E8E0 
00E900 
00E920 
O0E940 
00E960 
OOE980 



CCS A*ri*u& ... 
^ko~+n&ed & £?o8- 



t st ^f* 



-/ZcriAf fc fenf CC W (ckvruneJ? /nyt<**>i) 



38/ 



09uii.<*Bt <:uuuuuii. uuu^uuOO OOOOOOOO 

OOOOOOOO OOOOOOOO 8QO00000 

OOOOOOOO — SAME — 

OOOOOOOO OOOOOOOO AOOOOOOO 

00008000 0C002003I0000E758 

OO0OE758 00000000 *00000000 /OOOOOOOO 



09018033 60000021 09018054 60000020 

690106E 6000000F oioicsee 600000S3 

OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 

ounnnnnn /innnnnnn ,cn n co-, n 1000005A_ 
1 •¥ ^ 

ccw copy slock ^^ dooesco 

P0O0O0 OOOOOOQOi 



ccw copy BLOCK 



CCW aod&ev) i*t. C%W 



OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 



oooooooo^" flot&v* of Vtrfcstf cc 3 ^*~/?o66e<»> of WU. i^J. 



A CCB Copy 0JJOCK 



TfiAL BA.OCK 



'(£xioiK?)\ 
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Appendix G 

EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 



o 



_ BLOCK 0*7 
















017800 


40400440 40404040 C104E240 40404040 40404040 


40404040 


4040C340 


7E4004C9 


M AHS 


C . HI 


- 017820 


D5C4C5D9 40C2C5D3 C1D5C709 C901D24B 40E5C509 


C4C509C5 


400605E3 


E6C90202 


NOER BELANGRIJK. 


VEROERE ONTUIKK 


• 017840 


C5D3C9D5 C740E5C1 D540E2C9 E3E4C1E3 C9C54004 


D6C5E340 


C1C6C7C5 


E6C1C3C8 


ELING VAN SITUAT 


IE NOET AFGEMACH 


017860 


E340 




V40 


05C9C5E3 


40E5C5D9 


0605E309 


T WOROEN D . .N 


OG. NIET VERONTR 


_ 017880 


E4E2 




>06 


D9C4E340 


C7C5C505 


40C1D2E3 


USTEND. VOORLOPI 


G MOROT GEEN AKT 


• 0178A0 


C9C5 




140 


40404040 


40404040 


40404040 


IE ONDERNOMEN 




0178CO 
_ 017960 


4040 
4040 


Pu& 00 obwui, olcw^V) ooof 


:4o 


40404040 


40404040 


40404040 


** AFKORTINGEN 


»* 


• 017980 
017A20 


4040 
4040 


Duma, ouno/ pconuce & c//rf/yq 


140 


E5D6D6D9 


0306D7C9 


C75040C1 




• .VOORLOPIG. A 


- 017A40 


C6C7 


'C5 


05E3C9C5 


4040D7D3 


E3407E40 


F6EHERKT UGN . 


URGENTIE PLT . 


• 017*60 


0703 


tD9 


C7C505E3 


C9C5C3D6 


C4C57A40 


PLAATS 


URGENT I ECOOE. 


017A80 


4040 


•&n4y 0*f . 


)40 


40404040 


4040C140 


7E40C806 




A . HO 


- O17AA0 


D6C7 


f C5 


0303C9D1 


02C540C1 


02E3C9C5 


OGST URGENT. ONH 


IODELLIJKE AKTIE 


-• 017AC0 


40E5 


ActJUiA ^/ 5r CCh/ Co/V Block 
(£»- CC/6 CoW Alock)^ £7£% 


140 


40404040 


40404040 


40404040 


VEREIST 




017AE0 


4040 


it.r 


09C9D102 


4B40C1D2 


E3C9C540 


B . BE 


LANGRIJK. AKTIE 


m 01 7B00 


C9D5 


)40 


40404040 


40404040 


40404040 


IN NABIJE TOEKOM 


ST 


• 017B20 


4040 


)40 


40404040 


40000000 


00000000 






017B40 


0000 










.... 




- 017E60 
• 017E80 


0000 
0000 


)00 
)00 


0000005C 
0000012C 


00000000 
8004033C 


OOOOOOOC 
00000000 










017EA0 
_ 017EE0 


0000 
0000 


ccw)~ 'fj rtf? ' 

Sfc*f oft X/o a^eoi. 

8B9 200l)UUOWL2h4C740 C7C5D5C5 09C1I 
5C5I40404040TE2C503C5 C3E340C1 40C2E 


)F6 


404040F1 


404040F5 


404040FO 




6 15 


































_ 017F40 


0904 


TF3 


6000001 F 


09041812 


60000021 






• 017F60 

017F80 

_ 017FA0 


0904- 
0A041 
E3C9E 


374 
306 
4C7 


60000020 
D9400906 
40C2E840 


09041894 
E4E3C9D5 
C505E3C5 


20000025 
C540C1C3 
D9C905C7 








RATOR ROUTINE AC 


/ TIVEI SELECT A 


BUG BY ENTERING 


• 017FC0 


40D6D5C5K0404040/D6C640E3 C8CS40C6 06030306 


E6C9D5C7 


40D3C5E3 


E3C509E2 


ONE OF THE F 


OLLOWING LETTERS 


017FE0 


40C606D3|D3D6E6C5/C440C2E8 40C506C2 4B404040 


40404003 


40404DC5 


D5E3C5D9 


I FOLLOWED BY EOB 


L .ENTER 






-^/'T iAU^f^xA 4r U 


£ccmu6/+e</ fy 


/ sr CCtv/-' 


/ 




BLOCK 048 
















• 018000 


40C1D540 E4D5C5D5 C4C905C7 40D30606 075D4040 


4040C940 


404D07D9 


06C4E4C3 


AN UNENDING LOO 


P. 1^ .PROpUC^^ATjj 




o 
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Appendix G 

EXAMPLE OF A 
STAND ALONE 
DUMP OUTPUT 




079FEO 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 ................ ..... 

BLOCK 244 

07A000 00000000 00000000 00O00000 00000000 00000000 00000000 00000000 oooooooo 

07A020 — SAME— 

07A7E0 OOOOOOOO oooooooo oooooooo oooooooo oooooooo oooooooo oooooooo oooooooo 

block 245* ^**^ Z * *^L£ sAtf <y*ut, eft OfiC ^UpUc*/ (>run«.) yje^yt- 

07A800 oooooooo oooooooo oooooooo oooooooo oooooooo oooooooo oooooooo oooooooo ................ ...... 

07A820 —SANE — 

07AFE0 OOOOOOOO oooooooo oooooooo oooooooo oooooooo OOOOOOOO oooooooo oooooooo ................ ..... 

END OF CORE DUMP 



















IJBSEGT CONTENTS IS TAKEN TC 


LOCATE THE SEGMENT TABLE 






• VIRT.A00R 


REAL ADOR 
000000 


BLOCK 
000 


STATUS 

CHANGED "\ 
CHANGED 








i 000000 






000800 


000800 


001 










001000 


001000 


002 


CHANGED 










001800 


001800 


003 


UNCHANGED 










002000 


002000 


004 


CHANGED 










002800 


002800 


005 


CHANGED 










003000 


003000 


006 


UNCHANGEO 










003800 


003800 


007 


CHANGED 










004000 


004000 


008 


CHANGED 










004800 


004800 


009 


CHANGED 










005000 


005000 


010 


CHANGED 










005800 


005800 


Oil 


CHANGED 










006000 


006000 


012 


CHANGED 










006800 


006800 


013 


UNCHANGED 










I 007000 


00700r 


014 


CHANGEO 


/ jf , 






<etr^ oosooo 


007800 
008000 


015 
016 


CHANGED 
CHANGED 








•^iO 008800 
_ 009000 
• 009800 


008800 
009000 
009800 


017 
018 
019 


CHANGED 
CHANGED 
UNCHANGED 








OOAOOO 


OOAOOO 


020 


CHANGED 










O0A800 


OOA800 


021 


CHANGED 










OOBOOO 


OOBOOO 


022 


CHANGED 










008800 


OOB800 


023 


CHANGEO 










OOCOOO 


OOCOOO 


024 


CHANGED 










0OC800 


OOC800 


025 


CHANGED 


1 








OODOOO 


OODOOO 


026 


CHANGEO 










000800 


00D800 


027 


CHANGEO 










OOEOOO 


OOEOOO 


028 


CHANGED 










00E800 


00E800 


029 


CHANGED 


I 








OOFOOO 


OOFOOO 


030 


CHANGEO 1 








• 


OOF800 


00F800 
010000 


031 
032 


CHANGED / 
CHANGED "\ 






_ 010000 




• 010800 


010800 


033 


CHANGEO 








011000 


011000 


034 


CHANGEO 








m 011800 


011800 


035 


CHANGEO 








• 012000 


012000 


036 


CHANGEO 








012800 
m 013000 
• 013800 


012800 
013000 
013800 


037 
038 
039 


CHANGED 
CHANGED < 
CHANGEO 


} S&fr*4HX 1 , o^ut /^ /*%** on re&£ 4^»r<t*9*- yw« 






014000 
A 014800 
~ 015000 


014000 
014800 
015000 


040 
041 
042 


CHANGEO i 

CHANGED 

CHANGED 


tUb su>f*«*"f C<z&* j&r £& 






01S800 
m 016000 

• 016800 

• 03D800 
03E000 

m 03E800 


015800 
016000 
016800 

03D800 
03EOO0 
03E800 


043 
044 
045 

123 
124 
125 


CHANGED 
CHANGEO i 
CHANGED / 


)//<, A*?M fnr»* Sep***** /^ / 




) 

CHANGED "N 
CHANGEO 
CHANGED / 






• 03F000 
03F800 


03F000 
03F800 


126 
127 


CHANGED \ 
CHANGED ) 






• 040000 
040800 

_ 041000 

• 041800 


020800 
019800 
017800 
018000 


065 
051 
047 
048 


CHANGED 1 
CHANGED ( 
CHANGED f 
CHANGED ) 








042000 

061000 
^ 061800 


018800 

01C800 
01D000 


049 

057 
058 


CHANGEO J 

CHANGEO 7 
CHANGEO i 
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»** 


COMMUNICATION 


REGION *♦* 












_ HEX 


BG 


F4 


F3 


F2 


Fl 










• DISP 


04A0 


4590 


44F0 


4450 


43B0 


COMMUNICATION REGION ADDRESS 








00 


12/06/73 


12/06/73 


12/06/73 


12/06/73 


12/06/73 


OATE 








_ 08 


7000 


7000 


7000 


7000 


7000 


PP8EG AOOR 








• OA 


7000 


7000 


7000 


7000 


7000 


END OF STORAGE PROTECT 








OC 


0000 


0000 


0000 


0000 


0000 


SEEK AODRESS BLOCK. ONLY BG VLD 








_ OE 


0000000000 


0000000000 


0000000000 


0000000000 


0000000000 


PROBLEM PROGRAM USERS 










00000000 


00000000 


00000000 


00000000 


00000000 


AREA IN HEX , 








17 


00 


00 


00 


00 


00 


UPSI BYTE IN HEX 








- 18 


TOMSDMP 


KENSLOOP 


NO NAME 


CALCSIM 


NO NAME 


JOB NAME 








• 20 


00060FFF 


00074FFF 


00000000 


000A1FFF 


00000000 


UPPERMOST BYTE OF EACH PPA 








24 


0004232F 


00063C5B 


00000000 


0008 AFF6 


00000000 


END ADDR OF LAST FETCH OR LOAO 








_ 28 


0004232F 


00000000 


00000000 


0008D40F 


00000000 


LARGEST PROBLEM PROGRAM PHASE 








• 2C 


0000 


0000 


0000 


0000 


0000 


LENGTH OF PP LABEL AREA 








2E 


0040 


0020 


0030 


0040 


0050 


PROGRAM IDENTIFICATION KEY 








A 30 


OOOBFFFF 


OOOBFFFF 


OOOBFFFF 


OOOBFFFF 


OOOBFFFF 


ENO OF STORAGE ADDRESS 








• 34 


FD 


FD 


FO 


FO 


FO 


MACHINE CONFIGURATION 








35 


7F 


7F 


7F 


7F 


7F 


SYSTEM CONFIGURATION 








2 m 36 


CEO33OA0CEO0 


CE033000CEO2 


CE030000CE50 


CE0330804EO0 


CE030000CE50 


JOB CONTROL SWITCHES 








3* 3C 


002E 


002E 


002E 


002 E 


002E 


DISK ADOR OF LABEL CYLINDER 








3E 


40F0 


40F0 


40FO 


40FD 


40FO 


AOOR OF FOCL 








_ *° 


4104 


4104 


4104 


4104 


4104 


ADDR OF PUB 










4296 


4296 


4296 


4296 


4296 


AODR OF FAVP 








44 


4297 


4297 


4297 


4297 


4297 


ADDR OF JIB 








_ 46 


4389 


4389 


4389 


4389 


4389 


AODR OF TEB 








• 48 


3F00 


3F00 


3F00 


3F00 


3F00 


ADDR OF FICL 








4A 


3F06 


3F06 


3F06 


3F06 


3F06 


ADDR OF NICL 








_ 4C 


3F0C 


3F0C 


3F0C 


3F0C 


3F0C 


ADOR OF LUB 








■• 4E 


38 


38 


38 


38 


38 


LINE COUNT FOR SVSLST 








4F 


120673340 


120673340 


120673340 


120673340 


120673340 


SYSTEM OATE 








_ 58 


0000 


0000 


0000 


0000 


0000 


LIOCS CON BYTE 








• 5A 


3CD4 


3C04 


3C04 


3C04 


3C04 


ADDR OF PIB TABLE 








5C 


0000 


0000 


0000 


0000 


0000 


LAST CHECK POINT NO. 








A 5E 


003C 


003C 


003C 


003C 


003C 


JOB ZONE IN MINUTES 








• 60 


4630 


46A8 


4720 


4798 


4810 


AODR OF DIB 








62 


0000 


0000 


0000 


0000 


0000 


CURRENTLY NOT ASSIGNED 








_ 64 


3DCC 


30CC 


3DCC 


3DCC 


30CC 


ADDR OF PC OPTION TABLE 








• 66 


3E4C 


3E4C 


3E4C 


3E4C 


3E4C 


ADDR OF IT OPTION TABLE 








68 


3EBC 


3EBC 


3EBC 


3EBC 


3EBC 


AODR OF OC OPTION TABLE 








m 6 * 


0010 


0010 


0010 


0010 


0010 


KEY OF PROGRAM WITH IT SUPPORT 








• 6C 


0000 


0000 


0000 


0000 


0000 


CURRENTLY NOT ASSIGNED 








6E 


0000 


0020 


0030 


0040 


0050 


LTK 








A 70 


00008090 


00008087 


0000807E 


00008075 


0000 80 6C 


SYSPARM 








• 74 


00007118 


000071DO 


00007288 


00007340 


000073F8 


JOB ACCOUNTING 








78 


00003864 


00003864 


00003864 


00003864 


00003864 


AODR OF TOD COMMUNICATIONS AREA 








_ 7C 


3B04 


3B04 


3B04 


3B04 


3804 


ADOR OF PIB EXTENSION 








• 7E 


5A30 


5A30 


5 A 30 


5A30 


5A30 


ADOR OF MICR DTF LABEL 








80 


00000000 


00000000 


00000000 


00000000 


00000000 


AOOR OF QTAH VECTOR TABLE 








A 8 * 


04A0 


04A0 


04A0 


04A0 


04 AO 


AOOR OF BG COMREG 








• 86 


10E0 


10E0 


10E0 


1OE0 


10EO 


RESERVED 








88 


00000588 


00000588 


00000588 


00000588 


00000588 


ADDR OF COMREG EXTENSION 








_ 8C 


COCO 


COCO 


COCO 


COCO 


COCO 


RESERVED 








• 8E 


03 


00 


00 


00 


00 


DISK CONFIGURATION BYTE 


(tx/wcl 
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**» 


PHYSICAL UNIT BLOCK TABLE *** 












• TOS 


CHAN 


CHAN 


TEB 


OEV OEV 


CHAN JOB OEV SUIT EOF IOERR OPER OEV BURST SEVEN 


* PUB OWNER • 










ANO 


QUE 


PTR 


TYP CODE 


SCHO CTL BUSY CHAB SYSROR QUEO INTV ENO OV ON TRACK 


** SHIP »» 










UNIT 


PTR 






FL6S FLOS LE SYSIPT RECOV REO POST MPX TAPE 


* EXTENSION • 








000 


0009 


04 


00 


00 00 


80 F8 * 




0000 








A 001 


OOOC 


FF 


00 


11 00 


00 F8 




0001 








• 002 


OOOD 


FF 


00 


21 00 


00 F8 




0001 








003 


OOOE 


FF 


00 


42 00 


00 F8 




0001 








^ 004 


001F 


FF 


00 


00 00 


00 F8 




0000 








• 005 


0111 


FF 


00 


BO FO 


00 F8 




0000 








006 


0130 


FF 


00 


62 00 


02 F8 




OOOB 








_ 007 


0131 


FF 


00 


62 01 


02 F8 




001F 








• 008 


0132 


FF 


00 


62 02 


02 F8 




0000 








009 


0133 


FF 


00 


62 03 


02 F8 




0000 








_ 00* 


0134 


FF 


00 


62 04 


02 F8 




0000 








• 008 


0260 


FF 


00 


63 OS 


02 F8 




001F 








OOC 


0261 


FF 


00 


63 06 


02 F8 




0000 








^ 000 


02 AO 


FF 


00 


50 C3 


00 CO 




0000 








• 00E 


02A1 


FF 


00 


50 C3 


00 CO 




0002 








OOF 


02A2 


FF 


00 


50 C3 


00 CO 




0002 








. 010 


02A3 


FF 


00 


50 C3 


00 CO 




0008 








• Oil 


02A4 


FF 


00 


50 C3 


00 CO 




0000 








012 


0380 


FF 


00 


50 C3 


02 CO 


* 


0002 








m 013 


0381 


FF 


00 


50 C3 


02 CO 


* 


0001 








• 014 


0382 


FF 


00 


50 C3 


02 CO 


• 


0008 








015 


0383 


FF 


00 


50 C3 


02 CO 


* 


0008 


fry/Stir 
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*** SEGMENT TABLE *** *** 


PAGE TABLE 


*** 










• ADOR.OF ST PT ENTRIES PT ORIGIN ADOR 
00E640 32 00E330 


VIRT.AODR 


REAL AOOR 
000000 


KEY 
00 


STATUS 
CHANGED 






i 


I 000000 






000 800 


000800 


00 


CHANGED 










001000 


001000 


00 


CHANGEO 










001800 


001800 


00 


UNCHANGEO 










002000 


002000 


00 


CHANGEO 










002800 


002800 


00 


CHANGED 










003000 


003000 


00 


UNCHANGEO 










003800 


003800 


00 


CHANGED 










004000 


004000 


oo 


CHANGED 










004800 


004800 


00 


CHANGEO 










005000 


005000 


00 


CHANGED 










005800 


005800 


00 


CHANGED 










006000 


006000 


00 


CHANGEO 










006800 


006800 


00 


UNCHANGED 










007000 


007000 


00 


CHANGED 








S-tfrne+vf O 


007800 


007800 


00 


CHANGEO 








008000 


008000 


oo 


CHANGEO 








/ 


008800 


008800 


00 


CHANGED 










009000 


009000 


00 


CHANGEO 










009 800 


009800 


00 


UNCHANGED 










OOAOOO 


OOAOOO 


00 


CHANGED 










00A8O0 


0OA800 


00 


CHANGED 










006000 


006000 


00 


CHANGED 










00B800 


00B800 


00 


CHANGED 










OOCOOO 


OOCOOO 


00 


CHANGED 










00C800 


00C800 


00 


CHANGED 










OODOOO 


000000 


00 


CHANGEO 










000800 


0OD8O0 


00 


CHANGEO 










OOEOOO 


OOEOOO 


00 


CHANGED 










00E800 


0OE8OO 


00 


CHANGED 










OOFOOO 


OOFOOO 


00 


CHANGED 










00F800 


0OF8O0 


00 


CHANGED 








# So 


/V* 














*** SEGMENT TABLE *** 


• ** 


PAGE TABLE 


»*« 










* ADOR.OF ST PT ENTRIES PT ORIGIN ADDR 


VIRT.AODR 


REAL AOOR 


KEY 


STATUS 








00E644 32 O0E37O 


010000 


010000 


00 


CHANGEO 










010800 


010800 


00 


CHANGED 










01 1000 


011000 


00 


CHANGED 










011800 


011800 


00 


CHANGEO 










012000 


012000 


00 


CHANGEO 










012800 


012800 


00 


CHANGEO 










013000 


013000 


00 


CHANGEO 










013800 


013800 


00 


CHANGEO 










014000 


014000 


00 


CHANGED „ 

changeo r/rC for 

CHAJ«tD / 










014800 


014800 


00 


#<? 








015000 


015000 


00 








W 


015800 


015800 


00 


^etfANGEO 








Scy^ne** 1 , 


016000 


016000 


00 . 


/changed 








1 016800 


016300 


UQ7 


CHANGEO 

NOT ADDRESSABLE 






• ' * 


\ 017000 






017800 






NOT ADDRESSABLE 










018000 




10 


NOT A00RESSABLE 










018800 




10 


NOT ADDRESSABLE 










019000 




10 


NOT ADDRESSABLE 










019800 




10 


NOT ADDRESSABLE 










01A000 




10 


NOT ADDRESSABLE 










01ASO0 




10 


NOT ADDRESSABLE 






la _ oibooo 




10 


NOT ADDRESSABLE 








□• or oibsoo 

Oy oicooo 




10 


NOT ADDRESSABLE 










10 


NOT ADDRESSABLE 










01C800 




10 


NOT ADDRESSABLE 










010000 




10 


NOT ADDRESSABLE 










010800 




10 


NOT ADDRESSABLE 










OlEOOO 




10 


NOT ADDRESSABLE 










01E800 




20 


NOT ADDRESSABLE 








' 


' 01FOOO 




20 


NOT ADDRESSABLE 








^ Q1F800 




20 


NOT A0ORESSABLE 


(fr/ZS/i 



















jr 



Figured part 16 of 20 

A.26 Appendixes. 



Appendix G 

EXAMPLE OF A 
STAND ALONE 
DUMP OUTPUT 



o 























033B00 




00 


NOT 


ADDRESSABLE 








034000 




00 


NOT 


ADDRESSABLE 








034800 




00 


NOT 


ADDRESSABLE 








035000 




00 


NOT 


ADDRESSABLE 








035800 




00 


NOT 


ADDRESSABLE 




. 




036000 




00 


NOT 


ADDRESSABLE 




% oetynt&MA 3 


S&MA 


036800 




00 


NOT 


ADDRESSABLE 1/ 


-A 




037000 




00 


NOT 


ADDRESSABLE 




/ 


/]\ 




037800 




00 


NOT 


ADDRESSABLE 








038000 




00 


NOT 


ADDRESSABLE 










038800 




00 


NOT 


ADDRESSABLE 










039000 




00 


NOT 


ADDRESSABLE 










039800 




00 


NOT 


ADDRESSABLE 










03A000 




00 


NOT 


ADDRESSABLE 










03A800 




00 


NOT 


ADDRESSABLE 










03B000 




00 


NOT 


ADDRESSABLE 










03B800 




00 


NOT 


ADDRESSABLE 










03C000 




00 


NOT 


ADDRESSABLE 










03C800 




00 


NOT 


ADDRESSABLE 










03D000 




00 


NOT 


ADDRESSABLE 










03D800 


030800 


00 


CHANGED > 










03E000 
03E800 
O3F000 


O3E0O0 
03E8O0 
03F0O0 


00 
00 
00 


CHANGED )//,// 1 
CHANGED ) ^WU AcHi of 
CHANGED [ / ./- 
CHANGED ; TC&X AA0KXJZ 

WJK)/ J<f / '0/1/0 1 








03F800 


03F8O0 


00 
















Oso6 , T i *Uty<l£~ aS&* Cti 














L%*i *OC4*nfiaZ ■ 


• ?->tjZ<r?Truuu*n o^fcw yr<«n 




r 










^ 


I700C SIKH 












Abr useo 


*7 


\ 


r 




/78oo 
/Soao 


n 


JwyZ- J7dc<?t*£' "L^ot. e*Kc£ze>o 




\ = ro/oj 




*? 






/Jo 


\/S9\/ 


litoo 


So 
Si 


m ' 


M4. 






/3f 




Ift"" 




/uctofk, y£ /tape* a^/ 
3 &&Xl4, a&o&zs&rrvl . 








it 


V 




6°*T a " 


J 


Xoeoo 


52 


Zolt'e, 




\ 


/feco 




















^ Ff V 








*** SEGMENT TABLE *** 




*** p 


AGE TABLE 


*** 






it 


• ADOR.OF ST PT ENTRIES PT ORIGIN ADDR 
00E650 32 00E430 




VIRT.A0DR 
040000 


REAL AODR 
020800 


KEY 
10 


STATUS 
CHANGED 




i 


\ 








040800 


019800 


10 


CHANGED 










041000 


017800 


10 


CHANGED 










041800 


018000 


10 


CHANGED 










042000 


018800 


10 


CHANGED 










042800 




10 


NOT 


USED 










043000 




10 


NOT 


USED 










043800 




10 


NOT 


USEO 










044000 




10 


NOT 


USED 




a J &Q/yrt&HSv / 






044800 




10 


NOT 


USED 








045000 




10 


NOT 


USED 




• y»rt*~~ , 






045800 




io 


NOT 


USED 










046000 




10 


NOT 


USEO 






B4V 


046800 




10 


NOT 


USED 






047000 




10 


NOT 


USED 








047800 




10 


NOT 


USED 








048000 




10 


NOT 


USED 










048800 




10 


NOT 


USEO 










049000 




10 


NOT 


USED 










049800 




10 


NOT 


USED 










04A000 




10 


NOT 


USED 










04A800 




10 


NOT 


USED 










04B000 




10 


NOT 


USED 










04B800 




10 


NOT 


USED 










04C000 




10 


NOT 


USED 










04C800 




10 


NOT 


USEO 










04DOOO 




10 


NOT 


USED 










040800 




10 


NOT 


USED 










O4E00O 




10 


NOT 


USED 










04E800 




10 


NOT 


USEO 










04FOO0 




10 


NOT 


USED 








v 


04F800 




10 


NOT 


USED 














Qx/rttfl 
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*** SEGMENT TABLE *»* 






*** 


PAGE TABLE *♦* 




V FZ 






/ STATUS / 
/ CHANGED 




ADDR.OF ST PT ENTRIES PT ORIGIN ADOR 
Q0E668 32 00E5B0 




VIRT.ADDR 
0A0000 


REAL AOOR KEY 
028800 40 ~) 






7 






FZV 


0AO80O 


028000 40 ( 


J CHANGED 










OAIOOO 


02A8O0 40 [ 


UNCHANGEO 












1 


0A1800 


02B000 40 > 
SO 


UNCHANGED 
NOT USED 






i 


I 


OA2000 










0A2800 


50 


NOT USED 














OA3000 


50 


NOT USED 














0A3800 


50 


NOT USED 














0A4000 


50 


NOT USED 














0A4800 


50 


NOT USED 














OA5000 


50 


NOT USED 














0A5800 


50 


NOT USED 














0A6000 


50 


NOT USED 








'i&ym&Kf 10 






0A6800 


50 


NOT USED 












0A7000 


50 


NOT USED 








/ 






0A78OO 


50 


NOT USED 














0A8000 


50 


NOT USED 














OA8800 


50 


NOT USED 














0A9000 


50 


NOT USED 














OA9800 


50 


NOT USED 














OAAOOO 


50 


NOT USED 














0AA800 


50 


NOT USED 














OABOOO 


50 


NOT USED 














0AB800 


50 


NOT USEO 














OACOOO 


50 


NOT USED 














OAC800 


50 


NOT USED 














OADOOO 


50 


NOT USEO 














0AD800 


50 


NOT USED 














OAEOOO 


50 


NOT USED 














OAE80O 


50 


NOT USED 














OAFOOO 


50 


NOT USED 














OAF8O0 


50 

/ 

/V/T ; 


NOT USED 










fl 


'V 














*** SEGMENT TABLE *** 






»»* 


PAGE TABLE *** 










ADDR.OF ST PT ENTRIES PT ORIGIN ADDR 






VIRT.ADDR 


REAL ADDR KEY 


STATUS 








00E66C 32 OOE5FO 






OBOOOO 
0B0800 
OBIOOO 
0B1800 
OB2000 
OB28O0 
OB3000 
0B3800 
08*000 
0B4800 
OB5000 


50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 


NOT USED 
NOT USED 
NOT USED 
NOT USED 
NOT USEO 
NOT USED 
NOT USED 
NOT USED 
NOT USED 
NOT USED 
NOT USEO 








5 Zym&nC / / 






0B5800 


50 


NOT USED 












0B6000 


50 


NOT USED 












0B6800 


50 


NOT USEO 








' 






0B7000 


50 


NOT USED 














0B7800 


50 


NOT USED 














0B8O00 


50 


NOT USEO 














0B8800 


50 


NOT USEO 














OB9000 


50 


NOT USED 














OB9800 


50 


NOT USEO 














OBAOOO 


50 


NOT USED 














0BA800 


50 


NOT USED 














OBBOOO 


50 


NOT USED 














0BB800 


50 


NOT USED 














OBCOOO 


50 


NOT USEO 














OBC800 


50 


NOT USED 














OBOOOO 


50 


NOT USED 














0BD800 


50 


NOT USEO 














OBEOOO 


50 


NOT USED 














0BE800 


50 


NOT USED 














OBFOOO 


50 


NOT USED 






^^^^^^^ 


„., . . . . . 


} 


' 


OBF800 


50 


NOT USEO 


prtz+xr 
























4 "\ 
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Appendix G 

EXAMPLE OF A 
STAND ALONE 
DUMP OUTPUT 











































*** PAGE FRAME 


TABLE *** 




•* 


PFT EXT 


** 












-FLAGS 


















ADDR.OF PFT 


FIX CNT 


NFF 


DR 


SP 


NF 


FORWARO-PTR 


BACKHARD-PTR 


PAGE NR 


ADDR.OF PAGE 


PF1X CNT 








m 000E88 


00000 








1 









000 


000000 


000 








• OOOE90 


00000 








1 









001 


000800 


000 








00DE98 


00000 








1 









002 


OOIOOO 


000 








A OODEAO 


00000 








1 









003 


001800 


000 








• 0OOEA8 


00000 








1 









004 


002000 


000 








OOOEBO 


00000 








1 









005 


002800 


000 








_ 000EB8 


00000 








1 









006 


003000 


000 








• OODECO 


00000 








1 









007 


003800 


000 








000EC8 


00000 








1 









008 


004000 


000 








_ OODEDO 


00000 








1 









009 


004800 


000 








• OO0ED8 


00000 








1 









010 


005000 


000 








OOOEEO 


00000 








1 









Oil 


005800 


000 








A OOOEE8 


00000 








1 









012 


006000 


000 








• OODEFO 


00000 








1 









013 


006800 


000 








00DEF8 


00000 








1 









014 


007000 


000 








m OOOFOO 


00000 








1 









015 


007800 


000 








• 000F08 


00000 








1 









016 


008000 


000 








OOOFIO 


00000 








1 









017 


008800 


000 








— 00DF18 


00000 








1 









018 


009000 


000 








• OODFZO 


00000 








1 









019 


009800 


000 








OOOF28 


00000 








1 









020 


OOAOOO 


000 








_ 00 OF 30 


00000 








1 









021 


OOA800 


000 








• 00DF38 


00000 








1 









022 


OOBOOO 


000 








00DF40 


00000 








1 









023 


0OB80O 


000 








m 00DF48 


00000 








1 









024 


OOCOOO 


000 








• 00DF50 


00000 








1 









025 


0OC80O 


000 








00DFS8 


00000 








1 









026 


OODOOO 


000 








_ 00DF60 


00000 








1 









027 


000800 


000 








• 00DF68 


00000 








1 









028 


OOEOOO 


000 








00DF70 


00000 








1 









029 


OOE800 


000 








_ 00DF78 


00000 








1 









030 


OOFOOO 


000 








• OODFBO 


00000 








1 









031 


OOF80O 


000 








O00F88 


00000 








1 









032 


010000 


000 








^ 00DF90 


ooooo 








1 









033 


010800 


000 








• 000F98 


00000 








1 









034 


OllOOO 


000 








OOOFAO 


ooooo 








1 









035 


011800 


000 








m 00DFA8 

~ OODFBO 

00DFB8 


ooooo 
ooooo 
ooooo 












1 
1 
1 











036 
037 
038 


012000 
012800 
013000 


000 
000 
000 


Az^e fratniL cU ae&rW) 






m OODFCO 


ooooo 








1 









039 


013800 


000 








• 00DFC8 
OODFOO 


ooooo 
ooooo 










1 
1 










040 
041 


014000 
014800 


000 
000 


-f O 1 O wxxa oce^tecf 






— 00DFD8 


ooooo 








1 









042 


015000 


000 


Off A<**e- /3Z t*d*c/ 






• OODFEO 
00DFE8 


ooooo 
ooooo 










1 
1 










043 
044 


015800 
016000 


000 
000 






_ OODFFO 
• 000FF8 


ooooo 
ooooo 










1 








00E068 


0OE288 


045 
UNUSED 


016800 


000 
000 


A*s> <*. i/cf£ZacK actto&ejA 






OOEOOO 


00001 








1 









130 


041000 


000 








m O0EO08 


00001 

ooooo 










1 








OOE090 


00E0C8 


131 
(132) 


041800 
C0420QO) 


000 
000 


<rf fyl,O0O 




• cooEoia) 




00E018 


ooooo 














00E078 


00E128 


315 


09D800 


000 


1 






3_ 00E020 


ooooo 














00E12 8 


OOEOFO 


129 


040800 


000 








O" 00E028 


ooooo 














O0EO98 


00E068 


UNUSED 




000 








00E030 


ooooo 














00E008 


00E048 


197 


062800 


000 








_ 00E038 


ooooo 














00E070 


OOEOAO 


310 


09BO0O 


000 








• 00E040 


ooooo 














OOE048 


00E2A0 


199 


063800 


000 


















**« PAGE FRAME 


TABLE *** 




** 


PFT EXT 


** 












-FLAGS- 





















AOOR.OF PFT 


FIX CNT 


NFF 


DR 


SP 


NF 


FORHARD-PTR 


BACKWARD-PTR 


PAGE NR 


ADDR.OF PAGE 


PFIX CNT 








— 00E048 


ooooo 














00E030 


00E040 


198 


063000 


000 








• 0OEO50 


00001 








1 









194 


061000 


000 








00E058 


ooooo 














O0E2AO 


00E060 


195 


061800 


000 








00E06O 


ooooo 














00E058 


OOE090 


196 


062000 


000 








• 00E068 


ooooo 














00E028 


00DFF8 


UNUSED 




000 








00E070 


ooooo 














OOEOFO 


00E038 


311 


098800 


000 








_ 00E078 


ooooo 














OOE080 


00E018 


312 


09COOO 


000 








• 00EO80 


ooooo 














00E088 


00E078 


313 


09C800 


000 








00E088 


ooooo 














OOEOBO 


00E080 


314 


09D000 


000 








_ 00E090 


ooooo 














00E060 


00E010 


128 


040000 


000 








• 00E098 


ooooo 














00E140 


OOE028 


UNUSED 




000 








OOEOAO 


ooooo 














00E038 


0OE138 


305 


098800 


000 








. 00E0A8 


ooooo 














OOEODO 


00E120 


281 


08C800 


000 








• OOEOBO 


ooooo 














00E118 


00E088 


274 


089000 


000 








00E0B8 


ooooo 














OOEOEO 


00E008 


277 


08A800 


000 








_ OOEOCO 


ooooo 














00E298 


00E118 


275 


089800 


000 








• O0E0C8 


ooooo 














O0E010 


OOEOOO 


279 


08B800 


000 








OOEOOO 


ooooo 














00E0C8 


O0E0A8 


280 


O8CO00 


000 








A ooEooe 


ooooo 














00E0B8 


0OE03O 


276 


08A00O 


000 








• 00E0E0 


ooooo 














00E120 


00E0B8 


278 


08BOOO 


000 








00E0E8 


ooooo 














00E0F8 


00E298 


319 


09F800 


000 








m OOEOFO 


ooooo 














00E020 


00EO7O 


309 


09A800 


000 








• 00 EOF 8 


ooooo 














00E100 


00E0E8 


318 


09F000 


000 








OOE100 


ooooo 














O0E108 


00E0F8 


317 


09E800 


000 








m 00E108 


ooooo 














O0E110 


00E100 


321 


0A0800 


000 








• 00E110 


ooooo 














00E130 


00E108 


320 


OAOOOO 


000 








^^^^^joEue^^^ 


ooooo 














OOEOCO 


OOEOBO 


316 


09EOOO 


000 


^^^^^^^^^^^^^&w# 
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Appendix H 

... t . . t , TABLES USED BY 

Job Account.ng Interface JQB ACC0UNT | NG 

The Job Accounting Interface provides job step and job information that you can 
use for charging system use, supervising system operation, planning new applica- 
tions, etc. 

The job accounting option is supported when JA=YES in the FOPT supervisor 
generation macro. When this option is supported, the following tables are 
generated: 

• A job accounting interface partition table for each partition 

• A job accounting common table. 

Both tables are generated as part of the supervisor. 

The interface table is part of the partition table and provides user access to the 
job accounting routines and information. 

For each job step the following information is accumulated in this table: 

Job name 

User information 

Partition ID 

Cancel code 

Record type 

Date 

Job start time 

Phasename (from EXEC card) 

Highest address used (from communications region) 

CPU time 

Overhead time 

Stop time (at EOJ only) 

All bound time 

SIO count (optional). 
Note: If the CPU is not equipped with a timer, time fields are zero. 

To utilize this information, you must link-edit a routine to be relocatable by using 
the relocating loader option (or write a self-relocating routine) to store or print 
the desired portions of the table. This routine must be catalogued in the core image 
library under the name $JOBACCT. 

How to locate 

The address of the interface partition table is contained in bytes X'74'— X'77' of 
the partition communication region. 

The address of the common table is contained in bytes X'7C'-X'7F' of 
SYSCOM. 
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TABLES USED BY 
JOB ACCOUNTING 



This part of the 
table is for * 
user reference 





Displacement 


Label 


Description 






(ACCTABLE) 






-3 


ACCTWK1 


Work area used in SIO update 




4 -7 


ACCTWK2 


Work area used with ACCTWK1 in start/stop time routine 




8 -11 


ACCTSVPT 


Job card pointer; address of job card field following jobname 




12 


ACCTPART 


ID of partition in charge (partition switch name) 




13 


ACCTRES2 


Reserved 




14-15 


ACCTLEN 


Length of SIO area = 6n+1 , where n = number of devices for this 
partition in SYSGEN option JA = n1 , n2, n3, n4, n5) 




16-21 


ACCTLOAD 


Label area instruction; moves JAI label area address to OPEN/CLOSE 
transients 




22-23 


ACCTRES3 


Reserved 




24-27 


ACCTLADD 


Address of alternate label area 




28-31 


ACCTPUT 


Counter for CPU time elapsed in a jobstep, counted in 300ths 
of a second 




32-35 


ACCTOVHT 


Counter for overhead time: time not charged to any partition 




36-39 


ACCTBNDT 


Counter for all-bound time: system wait state time divided between 
running partitions 


f 


40-47 


ACCTSVJN 


Save area for job name during simulated EOJ 


48-55 


ACCTJBNM 


Job name; taken from job card 




56-71 


ACCTUSRS 


User information 1 6 bytes from job card 




72-73 


ACCTPTID 


Partition ID: 'BG', 'F4', 'F3', 'F2'or 'F1'in EBCDIC format 




74 


ACCTCNCL 


Cancel code; see Cancel Codes and Messages 




75 


ACCTYPER 


Type of record: 'S' = job step, 'L' = last step of job 




76-83 


ACCTDATE 


Date in format specified at SYSGEN (MM/DD/YY or DD/MM/YY) 




84-87 


ACCTSTRT 


Start time of job, in packed decimal (DHHMMSSF; F = sign) 




88-91 


ACCTSTOP 


Stop time of job, in same format as ACCTSTRT 




92-95 


ACCTR ES 


Reserved 




96-103 


ACCTEXEC 


Phase name taken from execute card 




104-107 


ACCTHICR 


End address of active program phase, from COMREG 




108-111 


ACCTIMES 


CPU time elapsed in a job step counted in 300th of a second 




112-115 





Overhead time: elapsed time not charged to any partition, in 300ths 
of a second 




116-119 





All-bound time: system wait state time divided between running 
partitions, in 300ths of a sec. 




120 


ACCTSIOS 


SIO tables: 6 bytes for each device specified by SYSGEN options, 
as follows: 2 bytes for device address (Ocuu), 4 bytes for count of 
SIOs in current jobstep. 


K 






Overflow byte: normally X'20', but is X'30' if more devices are used 
within a partition than specified by SYSGEN options 



Notes: 



DSECT ACCTABLE symbolically addresses the JAI Partition Tables with labels as shown. Each 
partition in which JAI is supported has its own JAI Partition Table, labeled ACCTBG, ACCTF4, 
ACCTF3, ACCTF2 and ACCTF1 for active partitions BG, F4, F3, F2,and F1 respectively. 
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Figure H-l . Explanation of the contents of the Job Accounting Interface partition table. 
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Displacement 


Label 


Description 




(ACCTCOMN) 




0-15 


ACCTSVRG 


Temporary register save area 


16-17 


ACCTSVRX 


Save area for remainder of overhead counter times 
distributed by partition on exit 


18-19 


ACCTSVRE 


Save area for remainder of all-bound counter times 
distributed by partitions on entry 


20-23 


ACCTPCNT 


Count of partitions using the Job Accounting interface 


24 


ACCTSAID 


Owner of physical transient area *) 


25 


ACCTFAID 


Interrupted program *) 


26 


ACCTRAID 


Active program *) 


27 


ACCTSWCH 


Accounting switches: if bit = 1, true; if bit = 0, not true 
bit 0: cancel accounting bit 4: IPL indicator 
bit 1 : no active partitions bit 5: not used 
bit 2: catalog in process bit 6: not used 
bit 3: alternate label area bit 7: not used 


28-31 


ACCTIME 


Start time of current accounting interval, in complement 
format 


32-33 


ACCTRESC 


Reserved 


34-35 


ACCTUSEP 


Address of user save area (ACCTUSER) 


36-37 


ACCTUSEL 


Length of user save area (Set with 1st operand of FOPT 
macro parameter JALIOCS) 


38-39 


ACCTSJOB 


Job accounting partition indication 


40-43 


ACCTBLES 


Address of BG Job Accounting Table 



TABLES USED BY 
JOB ACCOUNTING 



#> 



If multiprogramming is supported, this table is to be extended with one of the 
following fields (depending on the number of supported partitions), otherwise the 
table ends here. 



44-47 
48-51 



44-47 
48-51 
52-57 



44-47 
48-51 
52-55 
56-63 



44-47 
48-51 
52-55 
56-59 
60-69 



Address of F1 Job Accounting Table 
ACCTSEAS Control Field: prevents the accounting routine being 

active in more than one partition simultaneously 



ACCTSEAS 



Address of F2 Job Accounting Table 

Address of F1 Job Accounting Tab|e 

Control Field: prevents the accounting routine being 

active in more than one partition simultaneously 



ACCTSEAS 



Address of F3 Job Accounting Table 

Address of F2 Job Accounting Table 

Address of F1 Job Accounting Table 

Control Field: prevents the accounting routine being 

active in more than one partition simultaneously 



ACCTSEAS 



Address of F4 Job Accounting Table 

Address of F3 Job Accounting Table 

Address of F2 Job Accounting Table 

Address of F1 Job Accounting Table 

Control Field: prevents the accounting routine being 

active in more than one partition simultaneously 



*) These values are the same as the PI K values for the relevant tasks 

Figure H-2. Explanation of the contents of the Job Accounting common table. 



►IMPARTS = 2 



► IMPARTS =3 



NPARTS = 4 



VNPARTS = 5 
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Programming considerations 

The user program for processing the information entered by the supervisor in the 
Job Accounting Table must be cataloged and be self relocating with the name 
SJOBACCT in a core image library. For efficiency, an overlay structure should be 
avoided, and the length of the program should preferably not exceed one core 
image library block. 

Because SJOBACCT is called in at the end of each job step, it should perform only 
data gathering and recording, but not data reduction and formatting if additional 
system overhead is to be held to a minimum. Overhead depends largely upon the 
efficiency of SJOBACCT. The optional SIO accounting (JA=nl , n2, n3) also 
causes additional overhead. 

LIOCS uses registers 13-1 5. If SJOBACCT needs any of these registers after a 
LIOCS function has been performed, save and restore the desired registers 
(register 14 should always be saved when using LIOCS because it is necessary to 
return to job control via the instruction BR 14). Chapter 9 in this section describes 
the usage of the general registers by system control programming and job accounting 

If SJOBACCT uses LIOCS, it should save at least part of the DTF information 
(status switches, extent information, and pointers) in the user save area. If more 
than one DTF is used, information from each should be saved. The user save area 
may be used to save any type of information as well as to accumulate step to 
step statistics for end job accounting. This accumulation reduces the rate of 
scheduled output records caused by writing a step accounting record for each job 
step. The user save area is not accessed by system functions. Chapter 12 in this 
section describes the save areas and the system generation macro JALIOCS. 

If an error causes SJOBACCT to be canceled, SJOBACCT is not called again until 
the system is re-IPLed. "JOB ACCT" appears in the cancel message, and the 
problem program name appear in the EOJ message. The STXIT option may be 
used to pass a message informing the operator that an error occured in SJOBACCT 
rather than in the problem program. (A description of tables used by user exit 
routines can be found in Section 4 of this manual, Chapter 10.) The job in that 
partition is terminated and normal processing continues with the next job. 

Refer to DOS/ VS System Management Guide for details on writing job accounting 
routines. 
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Appendix J 

PROCESSING TAPE ERROR 
STATISTICS USING EREP 



You can cause detailed or summarized tape statistics to be printed through the use 
of the various combinations of EREP options shown in Figure F-3-D in Section 2-F 
of this manual. The summarized format combines the individual recordings (for 
example, Unit Check, Volume Dismount, and End-of-Day records) either by volume 
serial number or by tape unit, and prints the summarized statistics. The detail format 
prints each recording in either volume serial number format or tape unit format. 
Whenever detail or summarized data is printed in volume serial number format, the 
data is printed in sequence by volume serial number. 

Example 1 : Print detail tape error statistics from SYSREC. The information is 
printed in the format of record 4 of the example printout below. Enter the following 
job control statements: 

// EXEC EREP 
OPTION TES,NOTAPE,PRINT 

/* 

Example 2: Print the summarized tape error statistics from SYSREC only. The data 
is printed in the format of record 3 of the example printout below. Enter the 
following job control statements: 

// EXEC EREP 
OPTION TES,NOTAPE,SUM 

/* 

Example 3 : Print the detail tape error records and then print their summary by 
volume serial number. The data is printed in the format of records 1 and 3 of the 
example printout below. The following job control statements: 

// EXEC EREP 
OPTION TES,NOTAPE,PRINT,SUM,SUMTAPE,VOL 

/* 

A work tape is required because the VOL option is specified-The work tape will 
contain a sequential list of all volume serial numbers along with a 5-byte disk 
address for each of these numbers. The message 

3E08A MOUNT SCRATCH TAPE ON SYS008 

is printed on SYSLOG. After the scratch tape is mounted the operator should 
respond END. If the operator chooses not to mount a work tape, he should respond 
CANCEL END. This causes the SUM and PRINT TES options to be canceled. Any 
other response results in the messages 

3E25I INVALID RESPONSE 

3E08A MOUNT SCRATCH TAPE ON SYS008 

being printed on SYSLOG. 
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PROCESSING TAPE ERROR 
STATISTICS USING EREP 



Example 4: Update the TES history tape on SYS007 . Then a scratch tape is 
mounted on SYS008. The error records are edited and printed from SYSRES onto 
SYSLST in the detail volume serial number format (record 2 of the example print- 
out below). The tape error records on the history tape are then summarized and 
printed on SYSLST in the summarized volume serial number format (record 1 of 
the example printout below). Enter the following job control statements: 

// LBLTYP TAPE 
// TLBL EREPNEW 
II EXEC EREP 

OPTION HIST 

OPTION TES,PRINT,SUM,SUMTAPE,VOL 

/* 

First the TES history tape is updated: the message 

3E09A MOUNT TES HISTORY TAPE ON SYS007 

is printed on SYSLOG. After the TES history tape has been updated, the tape error, 
data on SYSREC is edited. The message 

3E08A MOUNT SCRATCH TAPE ON SYS008 

is printed on SYSLOG. The tape data is printed on SYSLOG and then the message 

3E18A MOUNT HISTORY/RDE TAPE 

is printed on SYSLOG. The history tape is read and the tape error data is sum- 
marized by volume serial number. Finally, the history tape is updated and the 
SYSREC file is cleared. 



Vv 




An example of the EREP TES print formats. 
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able to the Model 145 



Appendix K 

EXAMPLES OF THE 
SUM OPTION OF EREP 



Example 1 : The job control statements required for a summary of the SYSREC file 
by disk, tape, unit record, and TP groups are: 

// EXEC EREP 
OPTION SUM 
GROUP=DISK,TAPE,UNITREC,TP 

/* 

Example 2: The control statements required for a summary of the SYSREC file 
by MICR/OCR, CPU, and 2715 hardware groups are: 

// EXEC EREP 
OPTION SUM 
GROUP=MICR/OCR,CPU,27 1 5 

/* 

The 2715 groups is summarized first 






Example 3: job entered through SYSIPT requesting the RDE Summary Option 

// JOB EXAMPLE 

// ASSGN SYS009 JC'283' 

//TLBLEREPNEW 

//LBLTYPTAPE 

// EXEC EREP 

OPTION SELECT,TAPE 

DEVICE=2314 

CUA=0134 
OPTION RDESUM 

OPTION RDESUM 

OPTION EDIT 
/* 
/& 

The RDE summary parameters will be requested on SYSLOG. 
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O 



RJE I/O TRACE 

An I/O trace for an RJE line after SIGNON can be initiated by specifying YES 
to TRACE = in the PRMT macro. 



Up to 127 entries of 32 bytes each. 
The last entry is followed by a blank 
line of 32 bytes. Thus, the last few 
entries can easily be located in a 
dump of the buffer 



Entries are made in a wraparound buffer in the phase IPW$$TM. The following 
information is recorded at every I/O interrupt from this terminal. 



-32 bytes- 




Trace entry 



The last line response sent or received 
from the terminal 

Sense information 



Last four bytes of data buffer 
(includes TP control characters) 



A data buffer with four records. 
(Number of records in a data 
buffer depends on type of terminal) 



The trace is to be used when RJE line errors occur or incorrect output is 
encountered which can be caused by the I/O operation. 



vy 



POWER/VS FILE DUMP PROGRAM 

This program enables any of the POWER/VS files (account, queue, data) to be 
dumped on a line printer assigned to SYSLST. An option is also provided to 
enable queue records and their associated track groups belonging to specific 
jobs to be dumped. 

How to Execute 

The program is requested by JCL commands entered either via SYSLOG or 
SYSIN, where SYSIN is assigned to a card reader. Before requesting ensure 
relevant assignments are made for the file to be dumped. 

Example Job Stream 

1 1 JOB name 

//ASSGN (SYS000 for Account file) 

(SYS001 for Queue file) 

(SYS002-6 for Data files) 
//EXEC IPW$$DD 



When the program is loaded successfully, the following message will be issued 
to SYSLOG: 

DUMP FUNCTION = 
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At this point one of the following options can be entered via SYSLOG: 

A (to specify the Account file) 

Q (to specify the Queue file) 1 

D (to specify the Data file) 

Jobname (jobnumber) (, queue) 2 

EOJ (to enable cancelation of the program or selection of a new option) 






1 The complete data file will be dumped. 

2 This enables (a) queue record (s) belonging to a specific job in the RDR, LST, 
or PUN queue plus its associated track group (s) to be dumped. Job name 
may be 8 characters, job number may be 6 characters. For the 'queue ' 
option one of the following three entries can be specified: 

L, for LST queue (default) 
P, for PUN queue 
R, for RDR queue. 

After the dump is completed, the message 

DUMP FUNCTION = 

is issued to SYSLOG again to enable either a new option to be specified or the 
program to be terminated by the option EOJ. 

Format of Output 

For every 100 bytes, a block of four lines is printed. Line 1 contains the 
printable characters in those bytes; line 2 contains the zone-part of each byte; 
line 3 contains the numeric part of each byte; line 4 contains a scale indicating 
the position of the bytes in the string. 



line 1 

line 2 

line 3 

line 4 



CHAR // JOB POWJOB01 
ZON 664DDC4DDEDDCFF44444444444 
NUMR 11016 20 7661620100000000000 
01. . .5. . .10. . .15. . .20. . .25. 



DATE 8/19/74, 
4444CCEC4FF6FF6FF6 
00004135008119174B 

« Oj • • • -/ U • • • -/ 3 • • • • • 
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OF THE POWER 

PARTITION 



Examine the TIBTAB to determine which tasks are active and which are ready to receive control. 



Cj 



(hex) 2C / 2F 38 




y y Generation options / (see Q] ) 



TIBTAB 



Device control tables. 
(DCTs) 



-4 POihter- 



Nowork task 



Operator communications task 



QFILE task 



DATAFIL 
tasks 



Private SSL task 



System SSL task 



ACCTFIL task 



Execution 
processor tasks 



Reader and 
writer tasks 



- to COREBLKS table (which consists of the DATABLKS and PROGBLKS 
tables) 



as many as disk volumes were specified in the NUMDDKS generation 
parameter 



► only present if SLI=YES was specified 

V only present if ACCOUNT=YES was specified 

► one per POWER supported partition in specified priority sequence 

► as many as were specified in the MAXRW generation parameter 



Format of a Tt.&TAB entry: 



TSB Task entry point 



Look up the associated TIB 



Pointer to TIB 

i i I 



a 



M 



m 



;X01' = task is active and either has control or is waiting for an I/O 

event to occur 
X03- : i¥ : i$£k »s *#dy to : r^<&^ie.,cof)lw<irf ivy^i&ri-' ¥fj- ^b^s? #' ":'t| 

. . -:j>ir»df»ty bihrtfefi'; fe<$ety''ei iboatfoi 
D^'dS' «-:OftN: r-edifi' arWri&Gvie^j^ ,,- 



o 



Figure K.l, part 3 of 9 



Appendixes. A.41 



Appendix K 

ANALYZING A DUMP 
OF THE POWER 
PARTITION 



Locate DCTs and analyze access queues: 



DEVICETB 



TIBTAB 



Private SSL DCT 



System SSL DCT 



ACCTFILDCT 



QFILE DCT 



DATAFILDCTs 



Unit-record and 
tape DCTs 



Pointer to 
QFILE DCT 



Pointer to 
CORESLKS 



only present if SLI=YES and a private SSL is assigned 
only present if SLI=YES 

only present if ACCOUNT=YES 



> as many as disk volumes were specified in the NUMDDKS 
generation parameter 



> as many as disk volumes were specified in the MAXCCB 
generation parameter 



TIBTAB table 



t 






The following is an illustration of a DCT access queue with three TIBs waiting to do I/O to the same DCT: 

DQPRTB DQPTRC 

DCT for an I/O device 7" 



(hex) 00 




Figure K.l, part 4 of 9 
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OF THE POWER 

PARTITION 

Except for the TIBs for reader and writer tasks, all TIBs are located in the POWER control blocks area of the 
POWER partition. The TIB for a reader or writer task is located in the program buffers (seeEl) allocated 
to the task. ^^ 





TIBACTN 


TIBSTAT 


TIBCHARD 




I 11 Tts 








mmm 



(hex) 00 



1D 



1E 



1F 



21 






L 



Identifies the type of the associated task: 

$OP = operator communication task 

bpp = execution processor task for the indicated 
partition :see^Q 

ppP = punch writer task for the pp partition 
ppR = reader task for the pp partition 
ppT = print writer task for the pp partition 

XXP = partition-independent punch writer task 
XXR = partition-independent reader task 
XXT = partition-independent print writer task 

where pp = partition identification: BG for background, 
F1 through F4 for foreground 1 through 4 

Indicates the action performed by the task when the 
error occurred: 

For an execution processor TJB: see £J 

For a reader TIB: see |£ 

For a print writer TIB: see |]| 

For a punch writer TIB: see [Qj 

For the operator communication TIB: see [j 

• Indicates why the task gave up the CPU or, if it has 
control of the CPU, that the last I/O performed was 
completed: 

For an execution processor TIB: see @ 

For a reader TIB: see Q 

For a print writer TIB: see Q 

For a punch writer TIB: see Q 

For the operator communication TIB: see Q 



Figure K.l , part 5 of 9. 
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Execution processor TIB. To locate an execution processor TIB see 
Input from SYSRDR: 



TIBRDRA 



(hex) 00 




TIBRDRB2 



First (or only) data buffer for input 
from SYSRDR. Size of buffer depends 
on value specified in the POWER 
generation parameter DBLK. 



74 



77 



t t 

1 Slze I = I sze 1 

_i 1_ 



Second data buffer (if used) for input 
from SYSRDR. Size of buffer 
depends on value specified in the 
POWER generation parameter DBLK. 



Output to SYSLST: 














TIBPRINT 




TIBPRNTA 


TIBPRTB2 


D^Z 


11 






if in 




/ 


(hex) 00 


80 


88111 


lll-li: 


8C >/8F 




A8 /AB 








First (or only) data buffer for output 
to SYSLST. Size of buffer depends 
on value specified in the POWER 
generation parameter DBLK. 



1 SZe I 

\ 



Second data buffer (if used) for 
output to SYSLST. Size of buffer 
depends on value specified in the 
POWER generation parameter DBLK. 



Output to SYSPCH: 

TIBPUNCH 



TIBPNCHA 



TIBPUNB2 




First (or only) data buffer for output 
to SYSPCH. Size of buffer depends 
on value specified in the POWER 
generation parameter DBLK. 



t t 



I size I = I size I 

I I 



Figure K.l, part 6 of 9. 
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DF 



Second data buffer (if used) for 
output to SYSPCH. Size of buffer 
depends on value specified in the 
POWER generation parameter DBLK. 



if i 



Page of GC33-S380-1, 
revised June 30, 1974, 
by TNLSN33-8780 



I Qj TIBSTAT of an execution processor TIB: 



Bit Meaning 

1 = SYSLST output for the current job entry will not be 

intercepted. 

1 reserved. 

2 1 = SYSPCH output for the current job entry will not be 

intercepted. 

3 1 = end-of-job processing for the current job entry takes place. 

4 1 = printed output is being intercepted. 

5 reserved. 

6 1 = punched output is being intercepted. 

7 1 = a job is being executed. 
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[3 TIBSTAT of a reader TIB: 

Bit Meaning 


1 
2 
3 
4 
5 
6 
7 



1 = task is going to be terminated. 

reserved. 

1 = Sequence of DISKETTE volumes is to be checked. 

reserved. 

1 = task is reading from a 3450. 

1 = both a card reader and a 3540 are assigned. 

reserved. 

1 = task is to be cancelled. 



TIBSTAT of a print writer TIB: 






Bit 

0-1 



Meaning 

10 = a stop command has been issued for the task. 

01 = a flush command for the current job has been issued for 
the task. 

11 = a restart command for the current job has been issued 

for the task. 
1 = a flush all command has been issued for the task. 
1 = the writer has completed output for the current job. 
1 = restart command directs the task to start from the 

beginning of the current job. 
reserved. 
1 = indicates to a tape writer that job separator pages are 

required. 
1 = a cancel command has been issued for the task 



Figure K.l, part 7 of 9. 
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UJ TIBSTAT of a punch writer TIB: 






Bit 

a 
1 

2 
3 

4-6 
7 



Meaning 

1 = a stop command has been issued for the task. 

1 = a flush command for the current job has been issued for the 
task. 

1 = a flush all command has been issued for the task. 

1 -the writer has completed output for the current job. 

reserved. 

1 = a cancel command has been issued for the task. 



[fll TIBSTAT of the operator communications task TIB: 

Bit Meaning 

0-6 Reserved. 

7 POWER command is entered while a previous command is being 

executed. 

|tj TIBACTN of an execution processor TIB: 

XW = disk I/O was in progress or just completed if the task was in control of the CPU. 
X'04' = the contents of a print or punch buffer are to be printed or punched, 

respectively. 
X'08' = a POWER EOJ card is to be processed. 
X'0C = an input card is to be read. 
X'10' = a PRT card is to be processed. 
X"I4' = a PUN card is to be processed. 
X"I8' = a message is being written on the console. 
X'1 C = either a JOB card (writer-only system) or an SLI card (reader system) is to be 

/processed. 
X'20' = a card from the Source Statement library is to be processed. 

Q TIBACTN of a reader or writer TIB: 

X'00' = disk I/O was in progress or just completed if the task was in control of the CPU. 
X'04' = the task waits for work. This code is set by the execution processor for the 
same partition: 

— for a reader task when all card input for a job is complete 

— for a writer task when all print (or punch) output for a job is complete. 
X'08' = The task waits for completion of 

— a read operation on the associated card reader if a reader task. 

— a print operation on the associated printer if a print writer task. 

— a punch operation on the associated card punch if a punch writer task. 
X'18' — The task has issued a message to the console and waits for completion of the 

typing operation. 

Ill TIBACTN of the operator communication TIB: 

X'00' = disk I/O was in progress or just completed if the task was in control of the CPU. 
X'04' = The task is inactive, that is, all commands have been processed. 
X'08' = the task has received a command and has initiated processing of same. 
X'10' = I/O for the ACCTFIL is in progress. 

X"I8' = the task has initialized writing a message on the console and waits for completion 
of the typing operation. 



\_,.^ 



Note: For POWER start up, the TIBACTN code has been assembled as X'08' and the TSB of the 
associated TIBTAB entry has been assembled at X'03'. 



Figure K.l, part 8 of 9. 
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OOS/VS pQftfttoft save ares C 



Operator eqmrhufMsatKwv 
traflsien* area 



ANALYZING A DUMP 

OF THE POWER 

PARTITION 

Locate the program and data buffers by means of 
pointers in the parameter list table and in the PROGBLKS 
andDATABLKS tables: 



COMMONDT 



POWER control blocks 



Parameter Hst table 



m 



(hex) 00 



48 



4B 4C 



4F 



B-Q 



Execution processor code md 
common subroutines 



Supervisor-state code 









PROGBLKS 


SB 


Pointer to program buffer 




SB 


Pointer to program buffer 


/ \ 


: 




SB 


Pointer to program buffer 



L 



SB = Status byte: 

X'00' = buffer not used 
X'03' = buffer used or 
no buffer exists 



Program buffers 







:&a*s : : : i&ftsrs: 



DATABLKS 


SB 


Pointer to data buffer 






J 




SB 


Pointer to data buffer 



Program buffers are generated only for reader and writer tasks. The number of program buffers generated 
is equal to the number specified in the MAXRW generation parameter. The format of a program 
buffer as shown below in the illustration on the left. The illustration on the right shows that two program 
buffers are acquired by a reader task using the 3540 as input reader. 



1K 
bytes 



\J 



TIB for task (see Q ) 



Phase entry and exit code 
(identical for all phases 
of a task) 



Phase code 



FGPSPOLx 



2K 

bytes 



Name of phase executing 
in the buffer, where 
x = phase identifier. 
The name's address is: 
A(TIB)+X'400'-8 



Figure K.1, part 9 of 9. 



TIB for task (seeQ) 



Phase entry and exit code 
(identical for all phases 
of the task) 



Phase code 



FGPSPOLx 



3540 control block 



Name of phase executing in' 
the buffer, where 
x = phase identifier. 

In a dump, the translated 
phase name can be used to 
locate the 3540 control 
block. 



> 
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The method of locating POWER/RJE control blocks and areas is shown in a series 
of illustrations in Figure L.l, parts 1 through 14. Notes within this figure provide 
information that will help you in determining the status a POWER/RJE task had 
at the time the dump was taken and in analyzing the contents of specific areas or 
bytes. 

The table below assumes that you have successfully located the POWER partition 
either (1) by tracing its beginning from the pointer in the active partition to the 
partition's save area or (2) by locating in the translated dump column the name you 
have used for the generation macro at the time of POWER/RJE assembly. 

The table does not include the steps that must be taken in order to locate normal 
POWER control blocks, such as an execution processor TIB or a reader or writer 
TIB, nor does it include information about how to analyze these POWER control 
blocks. For this information refer to Appendix K or the DOS/VS POWER Program 
Logic Manual. 

The reference table below is provided as a help in locating the information which 
you need to find a specific block or area in a dump. In the illustration, always look 
for the given reference to the left of text. 



Block or area to be located 


Reference to the Illustrations 


CCB (in DTFBT) 


M 


DTFBT 


M 


DECB (data event control block) 


J 


Generation options table 


D 


Parameter list table 


D 


RJEBLK (RJE block) 


H 


RJBLKLST (RJE block name list) 


K 


RJE TIB (RJE task information block) 


G 


RJLIST (RJE active task list) 


F 


RJUSERS (RJE list of authorized users) 


L 


TIBTAB (task information block table) 


D 
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If the POWER/ RJE program was assembled with a unique name for the 
generation macro you can look up that name in the left of the translated 
dump columns. 
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A 1 K area used for the execution of the operator communication 
transient phases. The last eight bytes contain the name of the phase 
that has been executing in the area. This name has the format 

FGPTYPxx 

where xx = phase identifiers 

The address of the name is: 

I X'78' I 
A (partition save area) +\ yea- ( + X'400'-8 



FESERVNO 156014 * D OS/ VS POWER v.d,M.d 



(hex) 14 



■& 



Generation Option table 



2B 2C 



»3 



fff V.d. = program version number 

M.d. = program modification number 

Locating this constant in the translated dump columns is a quick 
method of locating the beginning of the POWER/ RJE control 
blocks area. 



? 



DOS/VS partition save 
area 



Operator communication 
transient area 



FGPTYPxx 



BTMOD 
{ftJBTMOD* 



RJE block name 
fcst {KJBIKUST} 



User ID list 
(RJUSERS) 



ft 



POWER/RJE control 
blocks 



h 



Execution processor 

code and common subroutines 



Supervisor-state <$oda 



Program buffers 



Data buffers 

iiiiiiiiiiiiiiiiiiiiiiiiiii^^ 



(hex) 2C J 2F 30 / 33 34 



Generation 




options |f||f||§( 



3D 



^\ Analyze both the generation option switch and the options in the table. 
For details, see G\ 



\jf§^^»-:^^a^- - ^ ;{{}. 



GENSW 11111/ 



Figure L.l, part 1 of 14 



@ For full details about the fields of the table, see the "Data Area" section. 
For important switches, see Q 
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V 



j>» 



|IJ continued 



® 



Generation option table 



(hex) 2C 

♦ 

from beginning 
of FGPSPOOL 
CSECT (resident 
POWER code) 



34 



VV"V 

37 38 39 3A 3B 3C 3D 



D 



L 



'■^iiimtv^m-iyf CCB'a that amb* uaad f<?r unit 

: iw^inui!«: numW of ^at^tyjfers that the POWSR: , 
jprogiram can manage fMAX^Uf $} 

maximum number of RJE tasks that can be started at 
one time (MAXRJS) 

'-. maximum number of readers a>nidi writers lhat : can be 

|tS«6d '§j one time {MAXR W) : .. . / 

number <rf DATAfit <&** aflpwed (MUMpDKSl 
. i&rflper of tracks » a^rtfeft e«wp rfRAC*OP> 



Parameter list table 



11 



GENSW 111$ 
h— ****** 



(hex) 00 



130 131 



!pt Meaning if 1 * 

10 tAP€*Y£^ wa* specified 

t RpflCtOS^EXfT was specif ied 

i,2 .. ACCOU*m*Yt& was specif ied . 

3 RJE is included (MAXRJS=1 to 5 was specified) 

4 JOBSEP* YES was $pecifted 

5 RPS support 

6 JOB5EP=YES was specified 

7 D5425 = YES 

autostart for a reader task was specified 

t autostart for a pmt writer task wag specified 

2 autostart for 9 punch writer task was specified 

3 OtAG^YES was specified 

4 RJE=YES was specified 

6 ft£A*>£R*YE& was specified 

7 R£A0Effc*Y€S was specttted 



v^. 



Figure L.l, part 2 of 14 
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I 



Paraflmeter tot latite 

iWiuilililililiiiliuilililllil^^ 



^1 l-JH 1^? 



(hex) 00 



1D4 



1F2 



L 



TYPEIN+X'1 E': indicates buffers obtained for RJE task 
initiation 

Bits Meaning if 1 

0-2 reserved 

3 BIM's turnaroud data buffer obtained 

4 BIM program buffers obtained 

5 task s data buffer obtained 

6 RJEBLK program buffer obtained 

7 RJE task program buffer obtained 

Note: These switches are used only by FGPTYPS1 
and FGPTYPS2 

TYPEIN: 

X'00' = phase FGPTYPBO has finished executing 

X'FF' = an additional track group must be obtained 
for RJE messages, and the tracks of that 
group must be initialized as free message 
records. 

Note: This switch is used only by phases FGPTYPBO, 

FGTYPB1, and FGPTYPB2. 



Task ownership byte 




II 



(hex) 00 



60 61 



63 64 65 



67 



l_ 



address of the BIM simulator if the preceding byte 
is # X'00' 

X'00' = the BIM simulator is not in storage and the 

next three bytes are insignificant 
not X'00' = the BIM simulator is in storage 
(see Note below) 

address of BIM if the preceding byte is ^ X'00' 

X'00' = the BIM is not in storage and the next 

three bytes are insignificant 
not X'00' = the BIM is in storage 



Figure L.l, part 3 of 14 



Note: Each time a task requests the services of the BIM (or BIM simulator), 
the contents of the task ownership byte are shifted to the left by one bit 
position and bit 7 of the byte is set to 1 . Each time a task finished using 
the BIM (or BIM simulator), the contents of the task ownership byte are 
shifted to the right by one bit position and bit of the byte is set to 0. 
A copy of the byte's bit configuration for a specific task is contained in 
the RJBLKLST entry for that task (see Q ). 
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Generation options table 



2C 




33 34 



37 38 



TIBTAB 



/"> 



9 (see H and B > 







-0C 




pp. 






























Nowork task 




Op 


. communication task 






QFILE task 




* 


DATAFIL 
tasks 


/ 


> 


Private SSL task 


1 


System SSL task 


1 


ACCTFIL task 


) 


~~ ■ 


Execution 
processor 
tasks 





> 


* 


RJE tasks 
(up to five) 


• 




•■> 


Reader and 
writer tasks 


— 





3D 



•^ to QFILE DCT 



to RJLIST (see Q ) 
to COREBLKS table 



as many as disk volumes were specified in the 
NUMDDKS generation parameter 



only present if SLI=YES was specified 

only present if ACCOUNT=YES was specified 

one per POWER supported partition in specified 
priority sequence 






as many as were specified in the MAXRW 
generation parameter 



f§>ipi'if of ai ' : TJ&t A0 : €>h|ry; 



Look up the 
associated TIB 



TSB 



Task entry point 



Address of TIB 



!*! 



b 



1 

7*** 



Tac'fc. Action Mr < 
X'OO' » task is inactive {na task exists for this TJBTA8 entry) 



■*jij||X 01 = task is active and either has control or is waiting for an I/O event to occur 

X03' » tosk is ready to receive control when all tasks of higher priority cannot receive control 
X'05' <* unit record error recovery procedure ts m progress 



Figure L.l, part 4 of 14 
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OF THE POWER RJE 

PARTITION 



(^ only if the task is active; set to F'O' otherwise 



RJLIST* 



-* eight bytes ■ ► 


Address of DEC a 


Address of TIB 


Address of DECB 


Address of TIB 


Address of DECB 


Address of TIB 


Address of DECB 


Address of TIB 


Address of DECB 


Address of TIB 


X'FF' 


Reserved 


n 


Address of 2780 BIM 


n 


Address of BIM SIM 


Address of RJBLKLST 


Address of RJUSERS 


Address of RJBTMOD 



X'FF' = indicates the end of the list 

* contains as many entries as RJE tasks were specified in the MAXR 
Figure L.l, part 5 of 14 
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TIBTAB 



| R J LIST ~P/ { ^ Register 7* J * only if the associated task is active 



| Dcuuxxxx RJE TIB / 



>/ 

L 



name of RJE block that contains the RJE TIB (for further details about the RJE block, see Q ) 



cuu = line address at the central station 

xxxx = type of terminal used: 2770, 2780, or 3780 



:;.„-; : ; : ; jSffifjffi^Tjffi:-! TIBACTN 



TIBSTAT 



TIBCHARD 



(hex) 



1D 

\ .; /\- 



1E 1F 

-v '^— 



L 



21 



V_y 



contains the characters RJE 



Bit Meaning if 1 

stop the task 

1 flush the TP input and write a message to the 
work station operator 

2 a TP input record is available (a TPIO READ 
cannot be issued) 

3 (only if a 2780 is used) the first record in the 
data buffers has a space-immediate CCW and 
is preceded by a print-no-space CCW as the 
last record of the buffer used previosly 

4-7 reserved 

X'00' = disk I/O was in progress or just completed if 

the task was in control of the CPU 
X'04' s= the task waits for work 
X'07' - a TP READ INITIAL has been issued 
X'08' = a TIPO other than read initial has been issued 
X'1-8' = the task has issued a message to the console 
and waits for completion of the typing 
operation 
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^^itr 



continued 



RJE TIB 



If 



■TIBCODES (10 bytes) 



Iilttiiiiiiuil 



(hex) 



22 



26 



2B 



TIBCODES+4: indicates the transfer of control 
between the OUTPUT work station command 
processor, the print overlays and the punch overlays: 






X'16' 
X'18' 



X"IC = 



X'10' = print operations are in progress 

X'14' = punch operations are in progress or to be 
processed for an ALLUSERS request 
a punch job is to be placed in the hold state 
punched output is available for an 
ALLUSERS request or a jobname request if 
the JCT userid field is ALLUSERS 
the print overlays have transferred control 
directly to the punch overlays or punched 
output is available for userid for a jobname 
request 

X'30' = the punch overlays have transferred control 
directly to the print overlays or printed 
output is available for userid for a jobname 
request 

X'38' = printed output available for an ALLUSERS 
request or a jobname request if the JCT 
userid field is ALLUSERS 
a print job is to be placed in the hold state 
a print job is to be placed in local state for 
processing at a local output device 

X'70' = a print job is to be placed in local state for 
processing at a local output device 



X'50' 
X'60' 



TIBCODES (10 bytes) 






^n?*) 



(hex) 



22 



28 



2B 



TIBCODES+6: contains the address of the next TP 
input record or the data portion for TP output (this 
field is altered only by the BIM) 
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continued 



J 



TIBRDRWQ<4 bytes) 



*UE*JB 



li 



(hex) 



71 



72 



73 



Bit Meaning if 1 

: 0-5 reserved 

6 termination of reader overlay has been requested 

7 reserved 

■ 0-3 reserved 

4 the first record read was a JOB statement 

5 end-of-file on TP 

6 request for a track group is to be forced 

7 no track group found 

•0-1 reserved 

2 a DOS/VS job card was read 

3 FGPPRJE4 was called by FGPPRJEY 

4 an EOJ JECL statement is being moved to the 
data block 

5 an input record is available ( a TPIO READ 
cannot be issued) 

6 the first record is in a disk buffer 

7 a JOB JECL statement was read (JECL must 
control when the end of a job entry has been 
reached, not a DOS/VS /& statement). 



\J 



w$mm. 



TIBRDRB2 



TIBRDMR 



(hex) 



74 



77 78 



7B 



pointer to next available position for a logical record 
in the current data block 

-pointer to DECB used by the associated task 
(see HI for details) 



Figure L.l, part 8 of 14 
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continued 



liiiiiiiiiiililiiiiiiiiiii^S^^ Uiiiiil 



•TIBPRINT (40 bytes) 



II 



(hex) 



80 81 83 84 



87 A7 






address of last BTAM I/O - used for retries 

address of BIM being used 

C'R' = the task is in read mode 
C'W = the task is in write mode 

* X'00' = the switched line is disconnected 

* X'02' = an EOT received (no line disconnect) 
*X'04' = intervention is required at the work station 

* X'40' = stop was requested when a TPIO macro 

was issued 

* X'80' = an irrecoverable error has taken place 
*X'81' = timeout has occurred at the work station 

and the user session is terminated 

* settings that arise from TP exceptions when the 
task's TP exception routine is entered 



i, *m-m M 



-* TIBPRINT (40 bytes) *H 



II 



(hex) 



80 



8C 



M 



WfiWHW! 1 ! 1 






A7 



TIBPRINT+12: its bits are set by the TPCOMPL 
routine to indicate to the BIM that an exception has 
taken place: 
Bits Meaning if 1 

TPCOMPL has been entered 

1 an exception has taken place 

2 stop was requested since last TPIO was issued 
3-7 reserved 
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continued 






\ mm-M 



■TIBPRINT (40 bytes) 



II 



IJ 



(hex) 



80 



8D 8E 8F 



A7 



TIBPRINT +15 indicates input and TP buffer status: 
Bits Meaning if 1 

last block from DATAFIL was used to fill the 
TP I/O area 

1 input in TP I/O area was from a BTAM read 

2 last print block is in TP I/O area 

3 intervention required on print (EOT) 

4 the end of a data block was reached when the 

TP area was last filled with input stored on disk 

5 input in TP area is from the DATAFIL 
intermediate storage 

6 input is being transferred to a data block during 
TP read-to-write line turnaround 

7 input has been stored on the DATAFIL 

TIBPRINT+14 indicates the TPIO function 
requested when the BIM was last entered: 

X'02' = read 

X'04' = detach 

X'05' = punch 

X'06' = print 

X'07' = flush the input and write to the work station 

operator 
X'08' = write to the work station operator 
X'09' = open the RJE task DTFBT 
X'OA' = close the RJE task DTFBT 

TIBPRINT+13 indicates line direction: 

X'OO' = line is not initialized or is in control mode 
X'01' = CPU is receiving 
X'02' = CPU is transmitting punch records 
X'04' = CPU is transmitting print records 
X'08' = CPU is transmitting a message 



\ 
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RJE8LK 



Dcuuxxxx 



RJE TIB (see for details) 



ANALYZING A DUMP 

OF THE POWER RJE 

PARTITION 



Register 7*1 * only if the associated task is active 



DECB (seeEl for details) 



I/O area 






DTFBT (see Q] for details) 



DcuuxxxxA 



(hex) 



(hex) 00 




Note: For full details about switches maintained by 
BTAM, see the manual DOS Basic Telecommunications 
Access Methods, GC27-6989 



Figure L.l, part 11 of 14 



pointer to RJLIST (see Q ) 

X'OO' = task does not operate in simulation mode 
X'OT = task operates in simulation mode 

pointer to the DTFBT (see GSfl ) 

bit 1 is used to indicate the following: 

if = the task has control of the CPU or is waiting 

for a TP operation to complete 
if 1 = the task is ready to run 
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(hex) 



PNTRJBLK 



PNTTERM 



PNTUSER 



DEVCHAR 



1 



IkUUUUMiWMMUU 



(hex) 00 



2C 2 F 30 31. 33 34 37 38 3B, 



ES3 



0D OF 



L 



pointer to userid entry (in RJUSERS) representing 
the user currently logged on (for the format of a 
userid entry, see Q ) 

pointer to userid entry ( in RJUSERS) representing 
the accepted termid in the last acknowledged 
RJSTART command 

pointer to the RJBLKLST (RJE block name list) entry 
used to initiate the task (for the format on an 
RJBLKLST entry, seeQ) 

work station status: 

X'OO' = inactive 

X'01' = attached, but no user logged on 

X'03' = attached and processing (user is logged on) 

pointer to task ownership mask in BIM pointer 
behind the RJ LIST (see H) 



pointer to the I/O area 



| WC& 7p 



PNTRJBLK 



UiuiuiMiuikUM 



30 / 33 



[ 



nj 



BJB LK LST 

' ■ * ' * ■ • ♦ 



(hex) 00 



03 04 



07 08 



OF 



length of RJBLKLST 

number of entries (identical with number of RJE 
blocks) 






■ii 



■first RJE block name entry- 



Block name |;:ii|iieiii^ii: 



(hex) 00 



10 



17 18 1B1C 1D 1F 



m 



■7 bytes - 



A second and succeeding RJE block name entries 
Figure L.l, part 12 of 14 
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■ X'FF' = 



end of list 



pointer to DECB used by the associated RJE task 
(only valid if the preceding byte is * X'00' ) 

task's BIM ownership mask 






J 
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(hex) 00 




X'40' 

length of RJUSERS 



C, 



I >r 



RJUSERS entry 



Userid or Termid 



(hex) 00 



10 



17 18 1B 1C 1F 



JW" 



:-. . . .■'■"I 

Reserved | 



r_ 



number of entries (three bytes) 
X'FF' = end of list 
pointer to second DECB. if used 
pointer to first DECB 



@ second and succeeding RJUSERS entries; each of 
these entries has the same length as the first one 



(hex) 09 / 0C 




(hex) 00 01 



* all LCBs of a system have the same length 

length of an LCB 

number of LCBs contained in the DTFBT 
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continued 



o 



I DTFBT / | 



CCB (command control block) 



(hex) 00 



28 2A 2B 2C 



31 



o 



37 



pointer to the first CCW in the channel program 
a copy of the CSW status bytes 

Bit Meaning if 1 

data check in count area (OASD) 

1 track overrun (DASD) 

2 end of cylinder (DASD) 

3 2540 equipment check 

4 questionable condition 

5 reserved 

6 carriage channel 9 or verify error for DASD 

7 reserved 

traffic (wait) bit 

1 flag bit 

2 unrecoverable I/O error 

3 acceptable unrecoverable I/O error 

4 return DASD data checks to user 

5 post at device end 

6 return DASD data checks on count, read 
command, or verify command 

7 user error routine exists 

residual count from the CSW 
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QFILE 



Analyzing a QFI LE Dump 

A dump of the POWER disk file QFI LE can be very helpful if, for example, the POWER 
program failed because of a disk I/O error. Although analyzing the JCTs in the various queues 
may not isolate a problem, it may provide hints on how to define the problem still further. 
Figure M.1 parts 1 and 2 are provided to help you in analyzing a QFI LE dump. 






Byte 
(in hex) 





CC 
DO 



QFILE 
master record 



E8 




first JCT in print queue 
last JCT in print queue 
first JCT in punch queue 
last JCT in punch queue 
first JCT in reader queue 
last JCT in reader queue 
first JCT in purge queue 
last JCT in purge queue 



There is one such set of pointers for each POWER supported 
partition. These sets of pointers are arranged in the same 
sequence as the supported partitions were specified in the 
POWPART parameter of the POWER generation macro. 



Note: For 3330/3333 MCHR means the following: 



Record number 




Halfword containing the displace- 
ment into the data block. 



Head number 

= Cylinder number is less then 256 

1 = Cylinder number is 256 or higher 
eight low-order bits of the cylinder number 

POWER system logical unit number 



Figure M.l, part 1 of 2 
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Structure of a hypothetical QFILE (only one queue is shown): 



A 



QFILE master record 






:MI1 JCT JCT 



J \_J\ 



mm 



JCT 



JCT 



i\_LJ 



I 



JCT 



f!^ Layout of a QFILE master record (for further details refer to Figure 5.3): 






1 L-J. 



(hex) 






pointers 



X 



CB CC 



^ If ACCOUNT=YES was specified for POWER generation, this field points to the next available ACCTFIL 
record; otherwise the field is set to zero. 



|U Layout of a JCT (for further details refer to Figure 4.4): 



i i i i i 



■& 



irj^rST-Bnm 



(hex) 



8 9 



OC OD OE 



20 21 22 23 



l^ 



jf 



(T) Contains the DOS/VS or POWER job name; if no job name was specified, the field contains the character 
string AUTONAME. 

@ Contains the POWER assigned job number. 

^ Each of the bytes contains either CD' or C'H': 

D = dispatch (the job is ready for processing by the proper task) 
H = hold (the job is in the hold state) 

Byte OC: indicates the job's status in the reader queue. 
Byte OD: indicates the job's status in the printer queue. 
Byte OE: indicates the job's status in the punch queue. 

(^ Identifies the associated partition: BG, F1, F2, F3, or F4. 
^k Contains the class of the job's print or punch output. 
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TEST FOR THE 
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The online terminal test for the IBM 2780 and 2770 is an optional service provided 
by BTAM. It is provided to ensure proper operation of the system, and it may be 
used in the diagnosis and correction of a terminal malfunction. BTAM recognizes 
Request-for-Test messages transmitted by the remote work station. When an RFT 
message is recognized, BTAM performs the requested test, which is usually 
transmission of a tewt message. 

The BSC online test facility recognizes Request-for-Test message only if: 

1. BSCTEST=YES is coded in the RJE/BTMOD macro. 

2. TERMTST=YES is coded in the RJEBLK macro that assembles the DTFBT. 

3. The operation is a Read Initial. 

4. The application program issued a TWAIT with TERM TST= YES following the 
macro instruction that was executing when the RFT was received. 

5. If a 2770 terminal: 

a. The ONLINE TEST button is pressed. 

6. The RFT message is received without error. 

Because BTAM only recognizes RFT messages on a Read Initial, the RFT card must 
be read within 28 seconds to be received without error. Failure to submit the card 
within 28 seconds requires the user to send an RJSTART and RJEND card. The 
RJE task must issue a Read Initial before any RFT cards will be accepted. The on- 
line test facility is described in the DOS/VS Basic Telecommunications Access >d 
Method manual (GC27 -6989). 

The online test facility prints the results of the test on the computer console. Two 
messages are provided; one is used when BTAM is transmitting test messages (or 
RFT messages with X=0), the other when BTAM is receiving test messages. The 
content of these messages is: 

Transmitter Receiver 

Line Address Line Address 

Number of Transmissions (Y) Number of Transmissions 

X Field X Field 

Time-outs Time-outs 

NAK's Received Lost Data Occurrences 

Terminal ID (multipoint) Data Checks 
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The formats of these messages are: 

for the transmitter: 

4B70I ON-LINE TEST cuu xx yy TO NK TI 

for the receiver: 

4B71I ON-LINE TEST cuu xx yy TO LD DC 

where: 

4B70I identifies the messages as BSC online test results for the transmitter. 

4B71I identifies the message as BSC online test results for the receiver. 

cuu specifies the line in the form channel and unit. 

xx specifies the test type. This is the X field from the RFT message. 

yy specifies the number of transmissions. For the transmitter, this value is the 
value from the RFT message. For the receiver, this value is accumulated by the 
online test program. If online test was not successfully initiated, this field will 
contain zero. 

TO specifies the number of time-out occurrences. 

NK specifies the number of NAK's received by the transmitter. 

TI for multipoint lines, specifies the terminal ID; for point-to-point lines, it is 
blank or specifies the component selection sequence received with the RFT. 

LD specifies the number of occurrences of lost data. 

DC specifies the number of occurrences of data check. 

The following online test procedures may be used for switched and leased-line 
IBM 2780s. 



J 
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ONLINE TERMINAL 
TEST FOR THE 
IBM 2780/2770 
2780 ONLINE TESTS CONTENTION - PRINT 

Before operating these tests be sure that the customer's program has the online test 
features option in. Do not try to run these tests if online test in the customer's 
program is not available. 2780 setup: 

1. Place the Operate/Test switch on the data set cable and the CE panel in the 
operate position. 

2. Turn the Mode switch on the 2780 operator console to the TRANSMIT 
position. 

3. Flip the Online Test Switch on the CE panel to the ON position. 

4. Place the RFT (request for test message) card into the hopper. 

5. Ready the printer. 

6. Depress the Serial Reader Punch Start key to begin the test. 

SOH %01 PRINT TEST 

The purpose of this test is to transmit a test message card to the CPU. The CPU 
then transmits the data back to the 2780 that was contained in cc 8-80 of the 
test message card. The CPU sends this message to the 2780 as many times as 
indicated by the punch in cc 5 and 6 of the test message card. 

Format is as follows: 

Col Punches Character 

Indicates this card is an RFT (request for test 
message) card. 

Indicates the type of test requested. 

Indicates the number of times the test is 
requested (01-99). 

Denotes a contention terminal. 

This is the message the CPU will send back 
to the 2780. Columns 1.1—79 can contain any 
non-control characters. The ETX is shown in 
column 80, but it may be placed anywhere in 
the RFT card to denote the end of the message. 

This test should run to the 2780 without error indications. The data contained 
in cc 1 1—79 should print with single spacing the number of times indicated by 
cc 5 and 6. 



1 


12-1-9 


SOH 


2 


0-4-8 


% 


3 








4 


1 


1 


5 




Y 


6 




Y 


7 





0* 


8 


12-2-9 


STX 


9 


0-7-9 


ESC 


10 


0-1 




11 






80 


12-3-9 


ETX 
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SOH % 12 PRINT TESTS 

The purpose of this test is to request that a stored message from the CPU be sent 
to the 2780 terminal. The 12 designation indicates which transmission code the 
2780 terminal has that is requesting the test (EBCDIC). 

Format is as follows: 






:oi 


Punches 


Character 


l 


12- 


-1- 


-9 


SOH 


2 


0- 


4- 


8 


% 


3 








1 


4 








2 


5 








Y 


6 








Y 


7 












8 


12- 


-2- 


-9 


STX 


9 


12- 


-3- 


-9 


ETX 



Identifies this card as an RFT (request for test 
message) card. 

These columns designate a request for a 
stored message. 

Indicates the number of times the test is 
requested (01-99). 

Denotes a contention terminal. 

Ending sequence required by the CPU program. 



The following message will print in the 2780 without any errors. The message will 
be single-spaced and print the number of times indicated by cc 5 and 6 of the test 
message card. Each print line should look like this: 

ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789 



V_y 
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2780 ONLINE TESTS CONTENTION - PUNCH 

Before running these tests be sure that the customer's program has online test option 
in. Do not try to run these tests if online test feature is not available. 2780 setup: 

1. If the 2780 has the AutoTurnaround feature, depress the AutoTurnaround 
switch to place the 2780 in AutoTurnaround mode. If the 2780 does not have 
AutoTurnaround, install the following cards into the B gate: 
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Card Location 


6-Bit 


EBCDIC 


USASCII 


02B1B20 


None 


AJW (370643) 


None 


02B1C34 


DGV (370378) 


DHC (370372) 


DGV (370378) 


02B1C35 


DGT (370380) 


DGV (370378) 


DGT (370380) 


02B1C36 


DGU (370379) 


DGT (370380) 


DGT (370380) 


02B1C37 


DGV (370379) 


DGU (370379) 


DGV (370379) 


02B1C38 


DHC (370372) 


DHC (370372) 


DHC (370372) 


02B1C39 


AJW (370643) 


DHC (370372) 


None 



Note: The cards to be installed are the special test SMS cards included in the 2780 
shipping group. These cards must be removed before returning the 2780 to 
the customer. 

2. Place the Operate/Test switch on the 2780 data set cable and the CE panel into 
the operate position. 

3. Turn the Mode switch on the 2780 operator console to the transmit position. 

4. Flip the Online Test switch located on the CE panel to the ON position. 

5. Place the RFT (request for test message) card and a deck of blank cards into 
the hopper. 

6. Depress the Serial Reader Punch Start key to begin the test. 



o 



SOH %01 PUNCH TEST 

The purpose of this test is to transmit a test message card to the CPU. The CPU 
then transmits data to the 2780 that was contained in cc 8—80 of the test message 
card. The CPU will send this message as many times as indicated by the punching 
in cc 5 and 6 of the test message card. The 2780 automatically reverts to punch 
mode because AutoTurnaround was activated, or because the CE test SMS cards 
were installed as described in step 1 . 



Format 


is as follows 




Col 


Punches 


Character 


1 

2 


12-1-9 
0-4-8 


SOH 

% 


3 
4 



1 



1 


5 
6 




Y 
Y 


7 








8 
9 

10 
11 
80 


12-2-9 

0-7-9 

4 


STX 
ESC 

4 



Identifies this card as an RFT (request for 
test message) card. 

Indicates the type of test requested. 

Indicates the number of times the test is 
requested (01-99). 

Denotes a contention terminal. 

This is the message the CPU will send back to 
the 2780. Any non-control characters can be 
punched in cc 1 1—80. 



o 



This test should operate to the 2780 with no error indications. The 2780 should 
punch the data contained in cc 1 1—80 of the RFT card in cc 1—69 of the punched 
output card. 
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SOH % 13 PUNCH TEST 

The purpose of this test to request that a stored message from the CPU be sent to 
the 2780 terminal The 13 designation indicates which transmission code is to be 
used. The 2780 automatically reverts to punch mode because the AutoTurnaround 
feature was activated or because the CE test SMS cards were installed as described 
in step 1. 



Format 


is as 


follows 




Col 


Punches 


Character 


1 

2 


12- 
0-' 


-1-9 
4-8 


SOH 

% 


3 
4 






1 

3 


5 
6 






Y 
Y 


7 







o 


8 


12- 


-2-9 


STX 



Identifies this card as an RFT (request for test 
message) card. 

These columns indicate a request for a 
stored message. 

Indicates the number of times that a test 
is requested (01-99). 

Denotes a contention terminal. 

Ending sequence required by the CPU. 



/f~\ 



The 2780 should punch the following data into cc 1—36 of the output cards as 
many times as indicated by cc 5 and 6 of the test message Card. No errors should 
occur. 

ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789 

Note: Each punched output data card will be followed by a blank card. This is a 
normal indication caused by the way the 2780 reverts to AutoTurnaround 
mode. 
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Appendix N 

ONLINE TERMINAL 
TEST FOR THE 
IBM 2780/2770 
2770 ONLINE TESTS CONTENTION - PRINT 

Before operating these tests be sure that the customer's program has the online test 
features option in. Do not try to run these tests if online test in the customer's 
program is not available. 2770 setup: 

1. Turn the "Transparency" switch on the 2772 console off. 

2. Place the RFT (request for test message) card into the hopper. 

3. Press Check Reset and Term Reset at the 2772 console. 

4. Press START at the card reader. 

5. Press the ON Line Test button at the 2772 console. 

SOH %01 PRINT TEST 

The purpose of this test is to transmit a test message card to the CPU. The CPU then 
transmits the data back to the 2770 that was contained in cc 8—80 of the test 
message card. The CPU sends this message to the 2770 as many times as indicated 
by the punch in cc 5 and 6 of the test message card. 



Format 


is as follows 




Col 


Punches 


Character 


1 


12-1-9 


SOH 


2 


0-4-8 


% 


3 








4 


1 


1 


5 




Y 


6 




Y 


7 








8 


12-2-9 


STX 


9 


0-7-9 


ESC 


10 


0-1 




11 






80 


12-3-9 


ETX 



Indicates this card is a RFT (request for 
test message) card. 

Indicates the type of test requested. 

Indicates the number of times the test is 
requested (01-99). 

Denotes a contention terminal. 

This is the message the CPU will send back 
to the 2770. Columns 1 1—79 can contain any 
non-control characters. The ETX is shown in 
column 80, but it may be placed anywhere in 
the RFT card to denote the end of the message. 

This test should run to the 2770 without error indications. The data contained 
in cc 1 1—79 should print with single spacing the number of times indicated by 
cc 5 and 6. 
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SOH % 12 PRINT TESTS 

The purpose of this test is to request that a stored message from the CPU be sent 
to the 2770 terminal. The 12 designation indicates which transmission code the 
2770 terminal has that is requesting the test (EBCDIC). 



Format 


is as follows 




Col 


Punches 


Character 


1 

2 


12-1-9 
0-4-8 


SOH 

% 


3 
4 




1 

2 


5 
6 




Y 
Y 


7 








8 
9 


12-2-9 
12-3-9 


STX 
ETX 



Identifies this card as an RFT (request for 
test message) card. 

These columns designate a request for a stored 
message. 

Indicates the number of times the test is 
requested (01-99). 

Denotes a contention terminal. 

Ending sequence required by the CPU program. 



The following message will print in the 2770 without any errors. The message will 
be single-spaced and print the number of times indicated by cc 5 and 6 of the test 
message card. Each print line should look like this: 

ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789 



v..y 
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Appendix N 

2770 ONLINE TESTS CONTENTION - TRANSMIT ONLINE TERMINAL 

TEST FOR THE 

Before operating these tests, be sure that the customer's program has the online ' BM 2780/2770 

tests option in. Do not try to run these tests if ED 60 or Online feature is not 
available. 2770 setup: 

1. Turn the "Transparency" switch on the 2772 console off. 

2. Place the RFT (request for test message) card into the hopper. 

3. Press Check Reset and Term Reset at the 2772 console. 

4. Press START at the card reader. 

5. Press the On Line Test button at the 2772 console. 

SOH % 00 TRANSMIT TEST 

The purpose of this test is to allow the 2770 to transmit a deck of test cards to the 
CPU. The CPU responds with a DLE sequence if no error occurred during trans- 
mission; the CPU responds with a NAK if a CRC or VRC error occurred. There is 
no response for any other type of error. 

Format is as follows: 

Col Punches Character 

1 12-1-9 SOH Indicates that this is an RFT (request 

2 0—4—8 % for test message) card. 

3 Indicates the type of test required. 

4 

5 For this test, 1 is the only allowable 

6 1 1 number of messages to be sent (see note). 

7 Denotes the contention terminal. 

8 12-2-9 STX Data to be sent as a test. Columns 9-79 can 

contain any non-control characters. 

80 12-3-9 ETX Last card only. 

Note: Columns 5 and 6 of the transmit test must be 01. In order to transmit more 
than one card, a deck of cards must be punched with the same control 
characters in cc 1-8 and cc 80 of the test message card. Any non-control 
characters can be punched in cc 9- 79. Place this deck into the hopper and 
hold the start key depressed until a buffer is read. If the start key is not held 
depressed, only one card will be sent by the 2770. 

The test messages should be transmitted to the CPU and accepted by it without any 
errors. The audible alarm will sound for a short period after each card and will 
remain on at the end of this test. 
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TEST FOR THE 
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SOH %15 0R 16 WEAK DIBIT TEST 



y 



The purpose of this test is to request a stored message from the CPU. A stored 
message transmits the worst-case conditions for the data set and communication 
lines. When the RFT (request for test message) card has been transmitter and the 
audible alarm sounds, the 2780 mode switch should be turned to the print or 
punch position and either unit made ready. The output message (weak dibit) will 
then be printed or punched depending upon the position of Mode switch. 

Note: The user has 6 seconds to ready the output unit after the Mode switch is 
turned to the print or punch position. 

Format is as follows: 



Col 



Punches Character 



Identifies this as an RFT (request for test message) 
card. 

Identifies the type of stored message we are 
requesting (see note). 

Indicates the number of times we are 
requesting the test (01-99). 

Denotes a contention terminal. 

Ending sequence required by the CPU. 



Note: Columns 3 and 4 should be punched according to the transmission code and 
line facilities of the terminal involved. 



1 


12-1-9 


SOH 


2 


0-4-8 


% 


3 




X 


4 




X 


5 




Y 


6 




Y 


7 








8 


12-2-9 


STX 


9 


12-3-9 


ETX 



\y 



Transmission Code 


Column 3 


Column 4 


EBCDIC switched or IBM clock 


1 


5 


EBCDIC leased line 


1 


6 



The 2780 should print or punch the weak dibit message as many times as indicated 
by cc 5 and 6 on a test message card. No errors should occur during the test. If line 
errors occur during this test but not during any of the other online tests, the data 
set or communications line may be failing. The dibit characters may not print or may 
print as something else. Operating with no line check is the basic goal of this test. 
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Appendix N 

ONLINE TERMINAL 

TEST FOR THE 

IBM 2780/2770 



2770 ONLINE TESTS CONTENTION - PUNCH 

Before running these tests be sure that the customer's program has online test 
option in. Do not try to run these tests if online test feature is not available. 
2770 setup: 

1 . Be sure POWER is on for the 545 card punch and that it is initialized. 

2. Turn the "Transparency" switch on the 2772 console off. 

3. Place the RFT (request for test message) card into the hopper. 

4. Press Check Reset and Term Reset as the 2772 console. 

5. Press START at the card reader. 

6. Press the On Line Test button at the 2772 console. 



SOH %01 PUNCH TEST 

The purpose of this test is to transmit a test message card to the CPU. The CPU 
then transmits data to the 2770 that was contained in cc 8—80 of the test message 
card. The CPU will send this message as many times as indicated by the punching 
in cc 5 and 6 of the test message card. The 2770 automatically reverts to punch 
mode. 



Format 


is as follows 




Col 


Punches 


Character 


1 

2 


12-1-9 
0-4-8 


SOH 

% 


3 
4 



1 



1 


5 
6 




Y 
Y 


7 








8 

9 

10 

11 

80 


12-2-9 
0-7-9 

4 


STX 

ESC 

4 



Identifies this card as an RFT (request for test 
message) card. 

Indicates the type of test requested. 



Indicates the number of times the test is 
requested (01-99). 

Denotes a contention terminal. 

This is the message the CPU will send back 
to the 2770. Any non-control characters can 
be punched in cc 1 1—80. 



This test should operate to the 2770 with no error indications. The 2780 should 
punch the data contained in cc 1 1—80 of the RFT card in cc 1—69 of the punched 
output card. 

Note: Each punched output data card will be followed by a blank card. 
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SOU % 13 PUNCH TEST 

The purpose of this test to request that a stored message from the CPU be sent to 
the 2770 terminal. The 13 designation indicates which transmission code is to be 
used. The 2770 automatically reverts to punch mode. 

Format is as follows: 



Col 



Punches Character 



Identifies this card as an RFT (request for 
test message) card. 

These columns indicate a request for a 
stored message. 

Indicates the number of times that a test 
is requested (01—99). 

Denotes a contention terminal. 

Ending sequence required by the CPU. 



The 2770 should punch the following data into cc 1—36 of the output cards as 
many times as indicated by cc 5 and 6 of the test message card. No errors should 
occur. 

ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789 



1 

2 


12-1-9 
0-4-8 


SOH 

% 


3 
4 




1 
3 


5 
6 




Y 
Y 


7 








8 


12-2-9 


STX 
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2780 ONLINE TESTS CONTENTION - TRANSMIT AND WEAK DIBIT 

Before operating these tests, be sure that the customer's program has the online 
tests option in Do not try to run these tests if ED 60 or Online feature is not 
available. 2780 setup: 

1. Place the Operate/Test switch on the data set cable and on the 2780 CE panel 
to the operate position. 

2. Turn the Mode switch on the 2780 console to the transmit position. 

3. Flip the Online Test switch located on the CE panel into the ON position. 

4. Place the RFT (request for test message) card or cards into the hopper. 

5. Depress the Serial Reader Punch Start key to begin the test. 

The following online test procedures may be used for switched and leased-line 
IBM 2770s. 



SOH % 00 TRANSMIT TEST 

The purpose of this test is to allow the 2780 to transmit a deck of test cards to 
the CPU. The CPU responds with a DLE sequence if no error occurred during 
transmission; the CPU responds with a NAK if a CRC or VRC error occurred. 
There is no response for any other type of error. 

Format is as follows: 

Col Punches Character 

1 12-1-9 SOH Indicated that this is an RFT (request 

2 0—4—8 % for test message) card. 

3 Indicates the type of test required. 

4 

5 For this test, 01 is the only allowable 

6 1 1 number of messages to be sent (see note). 

7 Denotes a contention terminal. 

8 12—2—9 STX Data to be sent as a test. Columns 9— 79 can 

contain any non-control characters. 

80 12-3-9 ETX Last card only. 

Note: Columns 5 and 6 of the transmit test must be 01. In order to transmit more 
than one card, a deck of cards must be punched with the same control 
characters in cc 1-8 and cc 80 of the test message card. Any non-control 
characters can be punched in cc 9—79. Place this deck into the hopper and 
hold the start key depressed until a buffer is read. If the start key is not 
held depressed, only one card will be sent by the 2780. 

The test messages should be transmitted to the CPU and accepted by it without 
any errors. The audible alarm will sound for a short period after each card and 
will remain on at the end of this test. 



Appendix N 

ONLINE TERMINAL 

TEST FOR THE 

IBM 2780/2770 
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Appendix O 

PROCESSING TAPE ERROR 
STATISTICS USING EREP 



You can cause detailed or summarized tape statistics to be printed through the use 
of the various combinations of EREP options shown in Figure F-3-D in Section 2-F 
of this manual. The summarized format combines the individual recordings (for 
example, Unit Check, Volume Dismount, and End-of-Day records) either by volume 
serial number or by tape unit, and prints the summarized statistics/The detail format 
prints each recording in either volume serial number format or tape unit format. 
Whenever detail or summarized data is printed in volume serial number format, the 
data is printed in sequence by volume serial number. 

Example 1 : Print detail tape error statistics from SYSREC. The information is 
printed in the format of record 4 of the example printout below. Enter the following 
job control statements: 

// EXEC EREP 
OPTION TES,NOTAPE,PRINT 

/* 

Example 2: Print the summarized tape error statistics from SYSREC only. The data 
is printed in the format of record 3 of the example printout below. Enter the 
following job control statements: 

// EXEC EREP 
OPTION TES,NOTAPE,SUM 

/* 

Example 3: Print the detail tape error records and then print their summary by 
volume serial number. The data is printed in the format of records 1 and 3 of the 
example printout below. The following job control statements: 

// EXEC EREP 
OPTION TES,NOTAPE,PRINT,SUM,SUMTAPE,VOL 

/* 

A work tape is required because the VOL option is specified-The work tape will 
contain a sequential list of all volume serial numbers along with a 5-byte disk 
address for each of these numbers. The message 

3E08A MOUNT SCRATCH TAPE ON SYS008 

is printed on SYSLOG. After the scratch tape is mounted the operator should 
respond END. If the operator chooses not to mount a work tape, he should respond 
CANCEL END. This causes the SUM and PRINT TES options to be canceled. Any 
other response results in the messages 

3E25I INVALID RESPONSE 

3E08A MOUNT SCRATCH TAPE ON SYS008 

being printed on SYSLOG. 
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Example 4: Update the TES history tape on SYS007. Then a scratch tape is 
mounted on SYS008. The error records are edited and printed from SYSRES onto 
SYSLST in the detail volume serial number format (record 2 of the example print- 
out below). The tape error records on the history tape are then summarized and 
printed on SYSLST in the summarized volume serial number format (record 1 of 
the example printout below). Enter the following job control statements: 

// LBLTYP TAPE 
// TLBL EREPNEW 
// EXEC EREP 

OPTION HIST 

OPTION TES,PRINT,SUM,SUMTAPE,VOL 

/* 

First the TES history tape is updated: the message 

3E09 A MOUNT TES HISTORY TAPE ON SYS007 

is printed on SYSLOG. After the TES history tape has been updated, the tape error 
data on SYSREC is edited. The message 

3E08A MOUNT SCRATCH TAPE ON SYS008 

is printed on SYSLOG. The tape data is printed on SYSLOG and then the message 

3E18A MOUNT HISTORY/RDE TAPE 

is printed on SYSLOG. The history tape is read and the tape error data is sum- 
marized by volume serial number. Finally, the history tape is updated and the 
SYSREC file is cleared. 
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STATISTICS USING EREP 




An example of the EREP TES print formats. 
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EXAMPLES OF THE 
SUM OPTION OF EREP 



Note: This option of 
EREP is only applic- 
able to the Model 145 



Example 1 : The job control statements required jbr a summary of the SYSREC file 
by disk, tape, unit record, and TP groups are: 

//EXEC EREP 
OPTION SUM 
GROUP=DISK,TAPE,UNITREC,TP 

/* 

Example 2: The control statements required for a summary of the SYSREC file 
by MICR/OCR, CPU, and 271 5 hardware groups are: 

// EXEC EREP 
OPTION SUM 
GROUP=MICR/OCR,CPU,27 1 5 

/* 

The 2715 groups is summarized first 



Example 3: job entered through SYSIPT requesting the RDE Summary Option 

// JOB EXAMPLE 

// ASSGN SYS009,X'283' 

// TLBL EREPNEW 

// LBLTYP TAPE 

// EXEC EREP 

OPTION SELECT ,TAPE 

DEVICE=2314 

CUA=0134 
OPTION RDESUM 

OPTION RDESUM 

OPTION EDIT 
/* 
/& 

The RDE summary parameters will be requested on SYSLOG. 



\J 
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This glossary contains technical terms associated with the subject of this publication. A more general range of terms 
is contained in IBM Date Processing Glossary, GC20-1699. 

IBM is grateful to the American National Standards Institute (ANSI) for permission to reprint its definitions from the 
American National Standard Vocabulary for information Processing (copyright © 1970 by American National Standards 
Institute, Incorporated) which was prepared by subcommittee X3K5 on Terminology and Glossary of American 
National Standards Committee X3. These definitions are indicated by an asterisk. 



A 



B 



address translation. The process of changing the 
address of an item of data or an instruction from its 
virtual address to its real storage address. See also 
dynamic address translation. 

asynchronous, without regular time relationship. 

auxiliary storage. Data storage other than real 
storage; for example, storage on magnetic tape or 
disk. Synonymous with external storage, secondary 
storage. 



basic control mode. When PSW bit 12 is 0, PSW 

format and system operation are compatible with 
standard System/360 operation. This is the basic 
control mode in which control registers 0, 8, and 
14 are available to the system. Abbreviated to BC 
mode. See also "Extended Control Mode." 

BTAM (basic telecommunications access method). 
A basic access method that permits a READ/WRITE 
communication with remote devices. 

buffer. (1) A storage device in which data is 
assembled temporarily during data transfer. (2) During 
I/O operations, a portion of real storage from which 
data is read or into which data is written. 



channel program. One or more Channel Command 
Words (CCWs) that control(s) a specific sequence 
of channel operations. Execution of the specific 
sequence is initiated by a single start I/O instruction. 

channel program translation. In a channel program, 
replacement, by software, of virtual addresses with 
real addresses. 

command control block (CCB). A 16-byte field 
required for each channel program executed by 
physical IOCS. This field is used for communication 
between physical IOCS and the problem program. 

communication region. An area of the supervisor 
set aside for interprogram and intraprogram communi- 
cation. It contains information useful to both the 
supervisor and the problem program. Abbreviated 
comreg. (Not to be confused with the COM RG macro 
instruction). 



control program. A program that is designed to 
schedule and supervise the performance of data 
processing work by a computing system. 

control registers. A set of registers used for operating 
system control of relocation, priority interruption, 
program event recording, error recovery, and masking 
operations. 

core-wrap mode. The method of operation that 
records the events of a trace in the PD area or an 
alternate area (used by PDAIDS). It is the default 
process when no output device for a PDAID trace 
has been specified. 



DTF (define the file) macro instruction. A macro 
instruction that describes the characteristics of a 
logical input/ output file, indicates the type of 
processing for the file, and specifies the I/O areas 
and routines to process the file. 

default value. The choice among exclusive alternatives 
made by the system when no explicit choice is 
specified by the user. A default value is indicated by 
underlining in tables listing parameters. 

diskette. A flexible magnetic oxide coated disk, 
permanently enclosed in a semi-rigid protective 
plastic jacket approx, 8 inches square. During data 
processing operations the disk turns freely within 
the jacket. It is capable of storing 1898 128 character 
data records. 

dump. (1) To print out the contents of all or part 
of virtual storage or of auxiliary storage (2) The 
data resulting from the process as in (1). 

dynamic address translation (DAT). (1) The change 
of a virtual storage address to an address in real 
storage during execution of an instruction. (2) A 
hardware feature that performs the translation. 



emulator (1) * A device or computer program that 
emulates. (2) The combination of programming 
techniques and special machine features that permits 
a given computing system to execute programs 
written for another system. 
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environmental recording, editing, and printing 

(EREP). A program that processes the data 
contained on the system recorder file. 
error recovery procedures. Procedures designed to 
help isolate, and, when possible, to recover from 
hardware errors in equipment. The procedures are 
often used in conjunction with programs that record 
the statistics of machine malfunctions. 

error volume analysis (EVA). With this option, the 
system issues a message to the operator when a 
number of temporary read or write errors (specified 
by the user at system generation time) has been 
exceeded on a currently accessed tape file. 

event. An occurrence of significance to a task; 
typically, the completion of an asynchronous 
operation, such as input/output. 

extent. The physical locations on Input/Output 
devices occupied by or reserved for a particular 
volume. 

extended control mode. When PSW bit 1 2 is set to 1 , 
the PSW format is changed from that used for 
standard System/360 operation: the channel mask 
bits, instruction length code, and interruption code 
are removed, and additional mode and mask bits are 
included. This is the extended control mode, in 
which all control registers are available to the system 
for control of facilities that are particular to System/370. 
Abbreviated to EC mode. See also "Basic Control Mode." 



fetch. (1) To bring a program phase into real storage 
from a core image library or from the page data set 
for immediate execution. (2) The routine that 
retrieves requested phases and loads them. (3) The 
name of a macro instruction (FETCH) used to 
transfer control to the system loader. (4) To transfer 
control to the system loader. 

* file. A collection of related records treated as a unit. 
For example, one line of an invoice may form an item, 
a complete invoice may form a record, the complete 
set of such records may form a file, the collection of 
inventory control files may form a library, and the 
libraries used by an organization are known as its 
data bank. 



H 



fixed page. 

paged out. 



A page in real storage that is not to be 



F/L Trace (Fetch/Load Trace). A program that 
records information about phases and transients as 
they are called from a core image library. 

GSVC Trace (Generalized Supervisor Calls Trace). 

A program that records SVC interrupts as they occur. 
All or a selected group of SVCs can be traced. 



hard copy. A printed copy of machine output in a 
visually readable form, for example, a printed 
recording of the messages displayed on the System/370 
Model 125 video display unit. 

hard stop. A condition, usually caused by an error, 
in which the CPU is stopped and is not executing the 
microprogram. 

* hardware. Physical equipment, as opposed to the 
computer program or method of use, for example, 
mechanical, magnetic, electrical, or electronic devices. 
Contrast with software. 



I 



Input Job Stream. A sequence of job control state- 
ments entering the system, which may also include 
input data. 

interface. A shared boundary. An interface might 
be a hardware component to link two devices or it 
might be a portion of storage or registers accessed by 
two or more computer programs. 

interrupt. A break in the normal sequence of 
instruction execution. It causes an automatic transfer 
to a preset storage location where appropriate 
action is taken. 

invalid page. A page that cannot be directly addressed 
by the dynamic address translation feature of the 
central processing unit. 

I/O area. An area (portion) of real storage into which 
data is read or from which data is written, the term 
buffer is often used in place of I/O area. 

I/O Trace (Input/Output Trace). A program that 
records I/O device activity for all or a selected group 
of I/O devices. 

IOCS (input/output control system). A group of 
macro instruction routines provided by IBM for 
handling the transfer of data between main storage 
and external storage devices. 

irrecoverable error. A hardware error which cannot 
be recovered from by the normal hardware and retry 
procedures. 

job. (1) * A specified group of tasks prescribed as a 
unit of work for a computer. By extension, a job 
usually includes all necessary computer programs, 
linkages, files, and instructions to the operating 
system. (2) A collection of related problem programs, 
identified in the input stream by a JOB statement 
followed by one or more EXEC statements. 
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linkage editor. A processing program that prepares 
the output of language translators for execution. It 
combines separately produced object or load modules; 
resolves symbolic cross references among them, and 
generates overlay structures on request; and produces 
executable code (a load module) that is ready to be 
fetched into virtual storage. 

load. In programming, to enter instructions or data 
into storage or working registers. In DOS/VS, to bring 
a program phase from a core image library into virtual 
storage for execution. 

logic module. The logical IOCS routine that provides 
an interface between a processing program and 
physical IOCS. 

* loop. A sequence of instructions that is executed 
repeatedly until a terminal condition prevails. 

LSERV (label cylinder display). A program that 
formats a listing of the label cylinder located on 
SYSRES. 



M 



machine check analysis and recovery. A feature that 
checks the severity of a CPU hardware failure and 
attempts to recover from the interrupt. Abbreviated 
MCAR. 

machine check interrupt. The interrupt that occurs 
if the CPU fails to operate. 

main page pool. The set of all page frames in real 
storage not assigned to the supervisor or one of the 
real partitions. 

main storage. (1) The real address area of virtual 
storage. Contrast with auxiliary storage. (2) All 
program addressable storage from which instructions 
may be executed and from which data can be 
loaded directly into registers. 

microprogram. A set of basic or elementary machine 
instructions that is loaded into control storage to 
control CPU operations. 



transferring records over the multiplexer channel, 
time sharing it on a byte basis. 

multiplexer mode. A means of transferring records 
to or from low-speed I/O devices on the multiplexer 
channel, by interleaving bytes of data. The multi- 
plexer channel sustains simultaneous I/O operations 
on several subchannels. Bytes of data are interleaved 
and then routed to or from the selected I/O devices 
or to and from the desired locations in main storage. 
Multiplex mode is sometimes referred to as byte mode. 

multiprogramming system. A system that controls 
more than one program simultaneously by interleaving 
their execution. 

multitasking. The concurrent execution of one main 
task and one or more subtasks in the same partition. 



offline. (1) * Pertaining to equipment or devices 
not under control of the central processing unit. 
(2) Pertaining to program error diagnosis without 
using the computer system (offline program 
debugging). 

* online. (1) Pertaining to equipment or devices under 
control of the central processing unit. (2) Pertaining 
to a user's ability to interact with a computer. 

online test executive program (OLTEP). The control 
program of the online test system. OLTEP is the 
interface between the online test and the operating 
system. 

operand. (1) * That which is operated upon. An 
operand is usually identified by an address part of an 
instruction. (2) Information entered with a command 
name to define the data on which the command 
processor operates and to control the execution of 
the command processor. 

* overflow. (1) That portion of the result of an 
operation that exceeds the capacity of the intended 
unit of storage. (2) Pertaining to the generation of 
overflow as in (1). 



module. A program unit that is discrete and 
identifiable with respect to compiling, combining 
with other units, and loading, for example, the input 
to, or output from, an assembler, compiler, linkage 
editor, or executive routine. 

multiplexer channel. A channel designed to operate 
with a number of I/O devices simultaneously on a 
byte basis. That is, several I/O devices can be 



page. (1) A fixed-length block of instructions, data, 
or both, that can be transferred between real storage 
and external page storage. (2) To transfer instructions, 
data, or both between real storage and external page 
storage. 

page data set. An extent in auxiliary storage, in 
which pages are stored. 
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page fault. A program interruption that occurs when 
a page that is marked "not in real storage" is referred 
to by an active page. Synonymous with page translation 
exception. 

page frame. A 2K block of real storage that can 
contain a page. 

page frame table. In DOS/VS, a table that contains 
an entry for each frame. Each frame table entry 
describes how the frame is being used. 

processor. (1) * In hardware, a data processor. (2) * In 
software, a computer program that includes the com- 
piling, assembling, translating, and related functions 
for a specific programming language. RPG II processor, 
FORTRAN processor. (3) Same as processing program. 

Private Second Level Directory (PSLD). The Private 
Second Level Directory is a table, located in the 
Supervisor and containing the highest phasenames 
found on the corresponding directory tracks of the 
Private Core Image Library. 

page pool. The set of all page frames that may 
contain pages of programs in virtual mode. 

page table (PGT). A table that indicates whether a 
page is in real storage and correlates virtual addresses 
with real storage addresses. 

page translation exception. A program interruption 
that occurs when a virtual address cannot be translated 
by the hardware because the invalid bit in the page 
table entry for that address is set. See also segment 
translation exception, translation specification 
exception. 

paging. The process of transferring pages between 
real storage and the page data set. 

parameter. A variable that is given a constant value 
for a specific purpose or process. 

physical IOCS. Macro instructions and supervisor 
routines (Channel Scheduler) that schedule and 
supervise the execution of channel programs. 
Physical IOCS controls the actual transfer of records 
between the external storage medium and real 
storage. 

problem determination aids (PDAID). Programs that 
trace a specified event when it occurs during the 
operation of a program. The traces provided are: 
QTAM Trace, I/O Trace, F/L Trace, and GSVC 
Trace. 

problem program. (1) The user's object program. It 
can be produced by any of the language translators. 
It consists of instructions and data necessary to solve 



the user's problem. (2) A general term for any 
routine that is executed in the data processing 
system's problem state; that is, any routine that 
does not contain privileged operations. (Contrasted 
with Supervisor.) 

processing program. (1) A general term for any 
program that is not a control program. (2) Synonymous 
with problem program. 

program event recording. A System/370 feature that 
enables a program to be alerted to specific events. 
Abbreviated PER. 



Q 



R 



QTAM Trace. A program that records certain 
supervisor and I/O activities on tape or in core-wrap 
mode. 

queue. (1) A waiting line or list formed by items in 
a system waiting for service; for example, tasks to 
be performed or messages to be transmitted in 
message switching system. (2) To arrange in, or 
from, a queue. 



real address. The address of a location in real 
storage. 

real address area. In DOS/VS, the area of virtual 
storage where virtual addresses are equal to real 
addresses. 

real mode. In DOS/VS, the mode of a program that 
may not be paged. 

real storage. The storage of a System/370 computing 
system from which the central processing unit can 
directly obtain instructions and data, and to which it 
can directly return results. Synonymous with processor 
storage. 

real partition. In DOS/VS, a division of the real 
address area of virtual storage that may be allocated 
for programs that are not to be paged, or programs 
that contain pages that are to be fixed. 

recovery management support. The facilities that 
gather information about hardware reliability and 
allow retry of operations that fail because of CPU, 
I/O device, or channel errors. Abbreviated to RMS. 

reenterable. The attribute of a set of code that 
allows the same copy of the set of code to be used 
concurrently by two or more tasks. 

reliability data extractor (RDE). A function that 
provides hardware reliability data that is analyzed by 
IBM. 
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relocatable iibrary. A library of relocatable object 
modules and IOCS modules required by various 
compilers. It allows the user to keep frequently used 
modules available for combination with other 
modules without recompilation. 

resource. Any facility of the computing system or 
operating system required by a job or task, and 
including main storage, input/output devices, the 
central processing unit, data files, and control and 
processing programs. 

Rotational Position Sensing. A standard feature of IBM 
3330/3333 and an optional feature of IBM 3340 disk 
storage devices. It permits a device to disconnect from 
a block multiplexer channel (or its equivalent on Model 
31 15/3125 CPUs) during rotational positioning opera 
operations, thereby allowing the channel to service other 
devices on the channel during the positioning delay. 

routine. An ordered set of instructions that may have 
some general or frequent use. 



Second Level Directory (SLD). The table, located 
in the Supervisor and containing the highest phase- 
names found on the corresponding directory tracks 
of the system core image . 

segment. A continuous 64K area of virtual storage, 
which is allocated to a job or system task. 

segment table (SGT). A table used in dynamic 
address translation to control user access to virtual 
storage segments. Each entry indicates the length, 
location, and availability of a corresponding page 
table. 

segment translation exception. A program interruption 
that occurs when a virtual address cannot be translated 
by the hardware because the invalid bit in the segment 
table entry for that address is set. See also page 
translation exception, translation specification 
exception. 

self-relocating. A programmed routine that is loaded 
at any doubleword boundary and can adjust its 
address values so as to be executed at that location. 

self-relocating program. A program that is able to 
run in any area of storage by having an initialization 
routine to modify all address constants at object time. 

selector channel. A channel designed to operate with 
only one I/O device at a time. Once the I/O device is 
selected, a complete record is transferred one byte at 
a time. 

SEREP. A stand-alone environment recording, 
editing, and printing program that makes the data 
contained in an error logout area of real storage 
available for further analysis. 
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Shared Virtual Area (SVA): The last part of the 
virtual system address space that contains phases 
which are reenterable and relocatable and which can 
be shared between partitions. 

soft stop. A condition in which the CPU has stopped 
processing but continues to handle any requested 
interruptions. 

stand-alone dump. A program that displays the 
contents of the registers and all of real storage and that 
runs independently and is not controlled by DOS/VS. 

subtask. A task in which control is initiated by a 
main task by means of a macro instruction that 
attaches it. 

* storage protection. An arrangement for preventing 
access to storage for either reading, or writing, or 
both. 

system generation. The process of tailoring the IBM 
supplied operating system to user requirements. 

system debugging aids. A set of routines provided 
to trace specific program events by using the program 
event recording facilities. Abbreviated SDAIDS. 

System Directory List (SDL). A list of highly used 
phases (either only in the system CIL or also in the 
SVA). This list is placed in the SVA. 

system recorder file. The data file that is used to 
record hardware reliability data. 

task. A unit of work for the central processing unit 
from the standpoint of the control program. 

task selection. The supervisor mechanism for 
determining which program should gain control of 
CPU processing. 

teleprocessing. The processing of data that is received 
from or sent to remote locations by way of telecom- 
munication lines. 

terminal. (1) * A point in a system or communication 
network at which data can either enter or leave. (2) Any 
device capable of sending and receiving information 
over a communication channel. 

Terminating partition. This is a partition owning a 
program which is in the process of being terminated 
either because of a program cancel condition or 
because of EOJ. 

trace. (1) To record a series of events as they occur. 
(2) The record of a series of events. 

* tracing routine. A routine that provides a historical 
record of specified events in the execution of a program. 
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track hold. A function for protecting DASD tracks 
that are currently being processed. When track hold is 
specified in the DTF, a track that is being modified by 
a task in one partition cannot be concurrently accessed 
by a task or subtask in another partition. 

transient area. An area in the supervisor used for 
temporary storage of transient routines, such as non- 
resident supervisor call or error-handling routines. 

transient routines. These self-relocating routines are 
permanently stored on the system residence device 
and loaded (by the supervisor) into the transient area 
when needed for execution. 

translation specification exception. A program inter- 
ruption that occurs when a page table entry, segment 
table entry, or the control register pointing to the 
segment table contains information in an invalid 
format. See also page translation exception, segment 
translation exception. 



U 



user program, see problem program. 

unrecoverable error, see irrecoverable error. 

utility program. A program designed to perform a 
routine task, such as transcribing data from one 
storage device to another. 



V 



virtual address. An address that refers to virtual 
storage and must, therefore, be translated into a real 
storage address when it is used. 



virtual address area. In DOS/VS, the area of virtual 
storage whose addresses are greater than the highest 
address of the real address area. 

virtual mode. In DOS/VS, the mode of a program 
which may be paged. 

virtual storage. Addressable space that appears to the 
user as real storage, from which instructions and data 
are mapped into real storage locations. The size of 
virtual storage is limited by the addressing scheme of 
the computing system and by the amount of auxiliary 
storage available, rather than by the actual number 
of real storage locations. 

virtual storage access method (VSAM). VSAM is an 
access method for direct or sequential processing of 
fixed and variable length records on direct access 
devices. The records in a VSAM file can be organized 
either in logical sequence by a key field (key sequence) 
or in the physical sequence in which they are written 
on the file (entry-sequence). A key sequenced file has 
an index, an entry-sequenced file does not. 

volume. (1) That portion of a single unit of storage 
media which is accessible to a single read/write mechanism, 
for example, a drum, a disk pack, or part of a disk 
storage module. (2) A recording medium that is 
mounted and dismounted as a unit, for example, a reel 
of magnetic tape, a disk pack, a data cell. 

VSAM access method services. A multifunction utility 
program that defines VSAM files and allocates space 
for them, converts indexed sequential files to key- 
sequenced files with indexes, facilitates data portability 
between operating systems, creates backup copies of 
files and indexes, helps make inaccessible files accessible, 
and lists file and catalog entries. 
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DOS/VS Linkage Editor Logic SY33-8556 
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AB option table 4.102 

ABSAVEarea 4.108 

ACB, contents of 4.76 

ACB macro 4.76 

Address trap, see stop on address 

see also data compare trap 
Address translation, see channel program translation 

see also converting address 
ALTER command 2.6 
example of output 2.6 
format of 2.6 
restrictions of use 2.7 
when to use 2.7 
ALTER/DISPLAY console operation all Models 2.1 31 
error indications Models 115/125 2.142, 2.143 
error messages, Models 135/145/155-11 2.132 
examples of display, Model 115/125 2.142, 2.143 
examples of displays, Model 158 2.144 
examples of output, Models 135/145/155-11 2.136 
how to use, operators flowchart 
Models 135/145/155-H 2.135 
Models 115/125 2.141 
Model 158 2.144 
options 

Models 135/145/155-11 2.134 
Models 115/125 2.140 
when to use 2.132 
Altering SDAID parameters (after SDAID initialization) 2.87 
Altering storage locations 

using the ALTER command 2.6 
using the ALTER/DISPLAY console operation 2.132 
Altering the contents of 
control registers 

Models 135/145/155-11 2.135 
Models 115/125 2.141 
Model 158 2.144 
general purpose registers 

Models 135/145/155-11 2.135 
Models 115/125 2.141 
Model 158 2.144 
virtual storage locations 

using the ALTER command 2.6 
using the ALTER/DISPLAY console operation 2.1 32 
Alternate area, for PDAID core-wrap output 2.41 
dumping 2.60 

example of, in a stand-alone dump output A. 16 
locating 2.60 
specifying 2.60 
Analyzing information (general) 1.28 
Analyzing information obtained from 
DSERV program 2.114 
EREP, example of 2.114 
Library display programs 2.115 
Linkage editor diagnostic of input 2.182 

examples of error indications 2.182, 2.183 
Linkage editor map 2.13, 2.166 
LSERV program 2.110 
LVTOC program 2.121, 2.122 
Map command 2.169 
PDAID trace routines 2.39 
SDAID trace routines 2.74 
Stand-alone dump, example of 
System dump, example of 2. 1 3 
SYSVISdump 2.130 

see also flowcharts (for the programmer) 4. 1 
Areas destroyed by the stand-alone dump program, 
example of, (in a stand-alone dump output) A.l 1 
see also non-critical area 
Assembler language macros 
Declarative macros 

forLIOCS 4.65,4.67 
forVSAM 4.72 



Assembler language macros (continued) 
Imperative macros 

forLIOCS 4.65 

forVSAM 4.72,4.73 
Module generation macros 4.68 
Supervisor communication macros 2.32 
VSAM file description macros 4.72 

SHOWCB macro, using 4.73 

TESTCB macro, using 4.73 



B 



Boundary box 4.115 

example of (in a dump output) A. 14, A. 25 
explanation of the contents of 4.1 15 
how to locate 4.115 



Cancel codes and messages 4.94 

causes of code X'2 1 ', 4 .24 

list of 4.94,4.95 

use of, and location 4.94 
Cancelling the SDAID non-destroying dump 2. 84 
CANCELV command 2.120 

example of 2.121 
Cathode ray tube, Model 115 and 125, example of 1.25 

see also Model 115 and 125 displays 

see also Model 158 displays 
CCB macro, example of 4.64 
CCW assembler instruction, example of 4.64 
CCW copy block 4.126 

example of, in a dump output A. 15 

format and contents of 4.126 
CCW/Translation control block 4.1 27 
Changing real address to virtual 4.1 18 

using the ALTER command 2.6 

using the ALTER/DISPLAY console operation 2.1 32 
Changing the contents of control registers 

Model 135/145/155-11 2.135 

Model 115/125 2.141 

Model 158 2.144 
Changing the contents of general registers 

Models 135/145/155-11 2.135 

Models 115/125 2.141 

Model 158 2.144 
Changing virtual addresses to real 4.116 
Channel Address Word (CAW) 2.171 

format and contents 2. 1 7 1 

how to locate 2.175 
Channel bucket 4.58 

examination of 4.58 

explanation of the contents of 4.59 

how to locate 4.58 
Channel Check Handler (CCH) 2.197 
Channel Command Word (CCW) 4.83 

format and contents 4.83 

how to locate 4.83 

see also channel program 
Channel control table 4.5 8 

explanation of the contents of 4.59 

how to locate 4.58 
Channel Status Word (CSW) 2. 172 

format and contents 2.172 

how to locate 2.175 
Channel Queue (CHANQ) 4.56 

examination of 4.56 

explanation of the contents of 4.57 

format of 4.57 

how to locate 4.56 
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C (continued) 

Channel program 4.82 

how to locate 4.83 
Channel program translation 4.120-4.128 
Clear, option of EREP 2.210 
Clear real storage, console operation 2.163 
Codes, list of, table of 

Cancel codes 4.94, 4.95 

causes of message 0S04I, list of 4.24 

control statements for DUMPGEN 

for DTF types 4.67 

for I/O device types 4.50-4.52 

for IPL reason information 2.204 

operands for the DUMP command 2.10 

options for ALTER/DISPLAY console operation 
Models 135/145/155-11 2.134 
Models 115/125 2.140 
Model 158 2.144 

options for DUMPGEN 2.16 

options for EREP 2.209 

options for LISTIO command/statement 2.168 

parameters for initializing PDAID 2.62 

parameters for the MODE command 2.205, 2.206 

parameters for initializing SDAID 2.88 

parameters for the SELECT option of EREP 2.212 

parameters for initializing the transient dump 2.28 

program check interrupt codes, list of 4.109 

SDAID output classes, table of 2.79, 2.280 

type of debugging aids, reference list 2.3 

wait state message codes 2.176, 3.3, 3.4, 4.6 
Combined recording 2.201,2.215 
Commands 

ALTER 2.6 

CANCELV 2.120,2.121 

DSPLY 2.8 

DSPLYV 2.120,2.122 

DUMP 2.10 

LISTIO 2.166,2.167,2.168 

LOG 2.168 

MAP 2.169 

MODE 2.205 

NOLOG 2.168 

ROD 2.203 
Computer output, see examples 
Command Control Block (CCB) 4.71-4.81 

examination of 4.77 

example of in a dump output 4.78, A.15 

format and contents 4.79-4.81 

how to locate 4.77 
Communication regions 4.34-4.43 

example of, in a dump output A. 13 

for each partition 4.34 

locating, example of 4.34 
COMRG macro 4.34 
Console dump operation (Model 1 15/125) 2.134 

operators flowchart 2.135 
Contents of, see explanation of the contents of 
Control of input and output, see IOCS 
Control registers 

allocation A.6 

altering the contents of and displaying 
Models 135/145/155-11 2.135 
Models 115/125 2.141 
Model 158 2.145 

dumping, see dumps 
Conventional dump, (Translating dump), example of A.l 1-A.30 
Converting Addresses 

real to virtual 4.118 

virtual to real 4.116 
Copying the Page Set (PDS) 2.126 
Core-wrap output, for PDAID 2.41 
CPU ID 

example of, in SDAID output 2.95 

example of, in stand-alone dump A. 12 



NDEX 



Current PSW 

dumping, displaying 

Models 135/145/155-11 2.135 
Models 115/125 2.140,2.141 
Model 158 2.145 

format and contents 2.173 



D 



Data compare trap 

Model 145 2.155 

Model 158 2.158 
Debuggers flowcharts, see flowcharts 
Debugging 1.4 

aids for, reference list of 2.3 

definition 1.4 

pictorial representation of 1.2, 1.5 
Debugging aid output, see examples 
Debugging hints 

for initializing SDAID 2.87 

forVSAM 4.72,4.73 

to analyze the stand-alone dump output 2.22, A11-A30 

to locate the CCB 4.78 
Declarative macro 4.65 
De-editing service program (ESERV) 2.116 
Define the file (DTF) macro 4.65 

contents of a DTFMT 4.66 

example of a DTFMT 4.70 
Description of 

Cancel codes 4.94 

Channel program 4.82 

Channel program translation 4.120 

Command Control Block (CCB) 4.76 

Control registers A.6 

Debugging 1.4 

DUMPGEN program 2.15 

EREP 1.23, 2.207 

ESTVUT 2.219 

EVA 2.202 

General registers, uses of 4.96 

Hard wait 1.10 

Indicators, for wait/loop 1.12 

Incorrect output 1.13 

I/O device malfunctions 1.16 

Input/output control system 4.62 

Intermittent errors 1.14 

Job accounting interface A.31-A.34 

Label information cylinder display program ( LSER V) 2.102 

Logical IOCS 4.62 

Loop tracing 1.20 

Low address storage 1.18, 2.171 

Machine Check Interrupt (MCI) 2.196 
illustration of 2.191 
Soft MCI 2.192 
Hard MCI 2.192 

MAP command 2.169 

Models 115/125 maintenance log analysis 1.25, 2.230 

Model 158 display frames 1.26,2.2 

OLTEP 2.234 

Page management 4.112 

PDAID trace routines 2.39 

Physical IOCS 4.62 

Program check interrupt (PGMCHK) 1.15 

Program Interrupt Key (PIK) A.3 

Recovery Management Support (RMS) 1.21, 2.188 
illustration of 1.22,2.189 

Save areas 4.106 

SDAID dump facilities 2.75 

SDAID trace routines 2.74 

SEREP 1.24,2.226 

Soft wait 1.10 

Standalone dump program 2.18 
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INDEX D (continued) 

Description of (continued) 

Storage dumps 1.19,2.5-2.35 
Supervisor calls (SVCs) 4.84 
Supervisor I/O tables and information blocks 4.44 
SYSLOGID A3 
System Dump 2.12 
System malfunctions 1.6 
SYSVIS dump program 2.15 
Tables used by the page manager 4.112 
Transient dump program 2.25 
Unintended program loop 1 .8 

Volume table of contents display program (LVTOC) 2.1 1 £ 
Wait state 1.10 
Wait state messages 2.176 
Details of contents for 

Partition communication regions 4.35-4.41 
System communication region 4.42, 4.43 
Device type codes 4.50-4.52 

Discontinuing the SDAID non-destroying dump 2.84 
Display command, see DSPLY command 
Display frame (Model 158) 
Display operators Console (DOC) 1.25 

see also Models 115/125 display, examples of 
see also Model 158 frames, examples of 
Displaying libraries, SSERV, RSERV, CSERV, PSERV 2.1 11 
Displaying library directories, DSERV 2.1 1 1 
Displaying the contents of 

any partition, see DUMP command 
control registers 

Models 135/145/155-11 2.135 

Models 115/125 2.141 

Model 158 2.145 
Label information cylinder, see LSERV 
Libraries 2.111 
Logout areas, see SEREP 

see also maintenance program selection and log analysis 
Low address storage, see SDAID output classes (LOCORE) 

see also dumps 
Page management tables 

see SDAID output (PAGET AB) 2.79 
Partition 

see DUMP command 

see also DUMP and JUMP macro 

see also system dump or // OPTION DUMP 
Real storage, see ALTER/DISPLAY console operation 

see also SDAID output (DUMPREAL) 

see also stand-alone dump 
Small areas of real and virtual storage 

see DSPLY command 

see also Snap Shot dump 
Supervisor, see SDAID output (SUPVISOR) 

see also DUMP command 
SYSREC, see EREP 

SYSVIS (Page Data Set), see SYSVIS dump 
Virtual storage, see ALTER /DISPLAY console operation 

see also dumps 
Virtual storage locations 

see ALTER/DISPLAY console operation 

see also dumps 
Volume table of contents, see LVTOC 

see also CANCELV command 

see also DSPLYV command 
VSAM control blocks 4.74 
DSPLY command 2.8 
example of output 2.8 
format of 2.8 
restrictions of use 2.9 
when to use 2.9 
DSPLYV command 2.120 

examples of output 2. 1 21 
DTF type codes, list of 4.67 
DTFMT 

contents of 4.66 



DTFMT (continued) 

example of in a dump output 4.70 
in an assembly listing 4.70 
Dump Analysis 

Stand-alone dump output A.11-A.30 
System dump output 2.13, 2.14 
Transient dump output 2.31 
DUMP command 2.10 

examples of output 2.1 1 
format of 2.10 
operands 2.10 
when to use 2.11 
DUMP macro 2.34 

consideration of use 2.35 
format of 2.34 
information dumped 2.34 
when to use 2.35 
DUMPGEN 2.15 

control statement 2.17 
executing 2.15 
job stream example 2.17 
messages 2.17 
operands 2.16 
DUMPGEN and stand-alone dump 2.15 
DUMPS 

DSPLY command 2.8 

DUMP command 2.10 

DUMP macro 2.34 

Dumping the copy of SYSVIS to SYSLST 2. 1 27 

Dumping a partition 

using the DUMP command 2.10 

using the DUMP macro 2.34 

using the JDUMP macro 2.34 
Dumping communication regions 

SDAID output class 4 (COMREG) 2.79, 2.98 
Dumping low address storage 

SDAID output class 3 (LOCORE) 2.79, 2.97 
Dumping page management tables 

SDAID output class 5 (PAGETAB) 2.79, 2.97 
Dumping real storage 

SDAID output class 7 (DUMPREAL) 2.79 
Dumping SYSREC, see EREP 
Dumping SYSVIS (PDS) to tape or disk 2.126 
Dumping the alternate area 2.53, 2.60 
Dumping the logout areas, see SEREP 
Dumping the PD area 2.44, 2.56 
Dumping the supervisor 

SDAID output class 6 (SUPVISOR) 2.79 

see also DUMP command 
Dumping the SVA, see system dump 
Formatting dump 2.19 

example of A. 18- A. 30 
JDUMP macro 2.34 
Printing the contents of SYSVIS 2.128 
Printing the system recorder file, see EREP 
Printing the tape used for PDAID output (PDLIST) 2.41 
SDAID dump routines 2.75 

Dump on program check 2.85 

Non-destroying dump 2.84 

Stop and dump routines 2.83 
Snap shot dump 

PDUMP macro 2.32 

SDAID PDUMP, SDAID output class 8 (PDUMP) 2.83 
Stand-alone dump 2.18 

example of A.11-A.30 

pictorial representation of 1.19 
Stop on event and dump selected SDAID output 2.83 
System dump 2.12 
SYSVIS dump 2.125 
Translating dump, example of 2. 1 3 , 2. 1 4 
Transient dump 2.25 
Dumps controlled by JCS 2.12 
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D (continued) 

Dumps controlled by JCS (continued) 

// OPTION DUMP (system dump) 2.12 
Dumps invoked by operator command 2.6 

DSPLY (display) command 2.8 

DUMP command 2.10 
Dump on program check (SDAID) 2.85 

when to use 2.85 

see also // OPTION DUMP (system dump) 
Dynamic dump 

PDUMP macro 2.32 

SDAID PDUMP 2.78 
Dynamic reallocation of partition or page pool (DRAP) 2.1 96 



ED IT, option of EREP 2.210 
Editing, the source statement library 

using ESERV 2.116 

using SSERV 2.111 
Editor, linkage 2.181 
Environmental Recording, Editing, and Printing 1.23, 2.207 

description of options 2.210-2.215 

entering options 2.222 
through SYSIPT 2.223 
through SYSLOG 2.222 

example job stream 2.220,2.223 

example of output 2.224 

executing 2.220 

history tapes 2.222 

list of options 2.209 

logical units required 2.208 

operators flowchart, for executing 2.221 

relationship between EREP and SYSREC, illustration 2.1 94 

relationship between EREP and RMS; illustration 2.1 89 

system requirements 2.207 

when to use 2.225 
EREP history tapes 2.216 
EREP options 

description of 2.210-2.215 

list of 2.208,2.209 
Error Checking and Correction (ECC) 2.196 

Modes of 2.197 
Error detection with VSAM macros 4.73 
Error during IPL (flowchart) 3.3 
Error Frequency Limits (EFL) 2.196 

Threshold values 2.196 
Error Queue (ERRQ) 4.60 

examination of 4.60 

format and contents 4.61 

how to locate 4.60 
Error Recovery Procedures (ERP) 2.198 

illustration of system action 2. 1 93 
Error recovery block 4.60 

format and contents 4.61 

how to locate 4.60 
Error Volume Analysis (EVA) 2.202 

description and operation 2.202 

how and when to use 2.202 

system requirements 2.202 
ESERV 2.116 

errors during update 2.1 16 

how to use 2.116 

input to and output from 2.117 

lob stream example A.7 
ESTVUT 2.219 

contents and format output 2.219 

job stream example 2.219 
Examples 

computer output 

ALTER command 2.6 

ALTER/DISPLAY console operation 2.136 

assembler listing showing PIOCS macros 4.64 



INDEX 



Examples (continued) 

assembler listing showing the expansions of a DTFMT 4.70 

CANCELV 2.121 

DSERV 2.114 

DSPLY command 2.8 

DS PL YV command 2.122 

DUMP command 2.11 

EREP output 2.114 

Linkage editor map 2.181 

Locating the active communication region 4.35 

Low address storage 2.175 

LSERV 2.108,2.109,2.110 

LVTOC 2.121 

Job stream trace 2.167 

MAP command 2.169 

PDAID F/L trace 2.47 

PDAID GSVC trace 2.50 

PDAID trace 2.44 

PDAID QTAM trace 2.53 

PDUMP macro 2.33 

RSERV 2.115 

SDAID dump showing how to locate the page 

management tables 4.120 
SDAID initializing output 2.95 
SDAID job entry 2.96 
SDAID output class COMREG 2.98 
SDAID output class FASTREC, AUTOMATIC 2.99 
SDAID output class PAGETAB 2.97 
SDAID BR, IF, GA trace output class PSW 2.100 
SDAID page tracing routine output 2.99 
Stand-alone dump A.11-A.30 
System dump showing isolation of a program check, 

data exception 2.13,2.14 
System dump showing the partition save area 4. 1 06 
System dump showing the CCB 4.78 
System dump showing a DTFMT 4.70 
System status information 2.169 
Transient dump 2.4 

see also job stream examples 

see also Models 1 15/125 display, examples of 

see also Model 158 frames, examples of 

EXCP macro, example of 4.64 
Executing EREP 2.220 

entering options 2.220 
through SYSIPT 2.223 
through SYSLOG 2.222 

table of options 2.209 

operators flowchart 2.221 
Expansion flags for SYSCOM 4.43 
Explanation of SDAID initializing output 2.95 
Explanation of the contents of the AB option table 4.1 02 
Explanation of the contents of 

AB option table 4.102 

ACB 4.76 

Boundary box 4.115 

CCB copy block 4.124 

CCW copy block 4.126 

CCW:TCB 4.127 

Channel Address Word (CAW) 2.171 

Channel Bucket 4.59 

Channel control table 4.59 

Channel control Word (CCW) 4.83 

Channel control table 4.59 

Channel queue 4.57 

Command Control Block (CCB) 4.79-4.81 

DTFMT 4.66 

Error block 4.61 

Error recovery 4.61 

Error queue 4.61 
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INDEX E (continued) 



Explanation of the contents of (continued) 
EXLST 4.74 
FICL 4.46 
FLPTR 4.56 
FOCL 4.48 

Interrupt status information 4.109 
IT option request table 4.101 
IT option table 4.100 
Job Information Block (JIB) 4.55 
Label save area 4.108 
Line mode table A. 10 
Low address storage 2.174, 2.175 
LUB 4.47 
NICL 4.46 
OC option table 4.105 
Page Frame Table 4.114 
Page table 4.113 

Partition communication regions 4.35-4.41 
Partition save area 4.108 
PC option table 4.104 
PD area 2.56, 2.57 
PHO option table 4.103 
Program Information Block (PIB) 4.89-4.9 1 
PIB2 4.93 

Program Status Word (PSW) 2.173 
Programmer Unit Block (PUB) 4.48, 4.49 

PUBOWNERSHIP 4.53 
RPL 4.75 
SDarea 2.85 
Segment table 4.113 
System save areas 4.110 
System communication region 4.42, 4.43 
Supervisor transient area 2.195 



FASTREC output, see SDAID output classes 
FAVP 4.54 

how to locate 4.54 
File dump program A.40 
First On Channel List (FOCL) 4.48 

how to locate 4.48 
First In Class List (FICL) 4.46 

how to locate 4.46 
Fix information block 4.128 
Flags for SYSCOM 4.43 
Flowcharts, for the operator 

Action, in event of system malfunction 
during IPL 3.5 
job canceled by system 3.27 
recognized as a wait state 3.16 
recognized as an unintended loop 3.20 
recognized as incorrect output 3.26 
Initial system checks 3.15 
Stop on address compare 2.143 
Models 135/145/155-11 2.144 
Models 115/125 2.146 
Model. 158 2.159 
To copy SYSVIS (PDS) to disk 2.24 
To copy SYSVIS (PDS) to tape 2.24 
To dump real storage (Models 115/125 only) 2. 
To execute EREP 2.221 
To execute SEREP 2.227 
To execute the stand-alone dump 2.23 
To initialize PDAID 2.63 
To initialize SDAID 2.89 
To initialize the transient dump 2.29 
To trace a loop by instruction stepping 
Models 135/145/155-11 2.147 
Models 115/125 2.142 
Model 158 2.151 
To use the ALTER/DISPLAY console feature 
Models 135/145/155-11 2.135 
Models 115/125 2.141 



Flowcharts for the operator (continued) 

Model 158 2.145 
Flowcharts, for the programmer 

Error generate during IPL 4.5 

Hard wait with message in low address storage 4.7 

Hard wait with no message in low address storage 4.8 

Incorrect output 4.12,4.13 

Initial checks 4.3 

Job canceled by ILLEGAL SVC 4.25 

Job canceled for other reasons 4.26 

Program check in supervisor 4.27 

Program check in user program 4.19 

Soft wait 4.9 

Unintended loop 4.11 
FLPTR 4.56 

how to locate 4.56 
F/L trace 2.45 

examples of output 2.47 

format and contents of a trace entry 2.45 

tracing options 2.46 

when to use 2.46 
Format of SYSRES 2.104 
Formatting dump 2.19 

example of A.11-A.30 

generating, see DUMPGEN 
Free List Pointer (FLPTR) 

how to locate 
Further error isolation 1.27 



G 

Gathering information 1.17,4.2 

Hardware error recording and recovery 1 .22, 2. 

EREP 1.23,2.210 

Log analy sis display s 1.25,2.230 

Maintenance program selection 1.25, 2.230 

Recovery Management Support (RMS) 1.21, 2.188 

SEREP 1.24,2.226 
Linkage editor 2.181 
Loop tracing 1.20 

see trace routines 

see also tracing loop 
Low address storage 1 . 1 8, 2. 1 7 1 
Operator flowcharts 

on occurrence a program check interrupt 3.29 

when system in loop 3.22 

when system in wait state 3.16 

when system procedures obviously incorrect output 3.28 
Storage dump s 1.19 

see also dumps 

see also serviceability aids from the operator console 
General purpose registers 

Altering the contents of and displaying 

Models 135/145/155-11 2.135 

Models 115/125 2.141 

Model 158 2.145 
Dumping, SDAID output class 2 (GRP) 2.79 

see also dumps 
Displaying 

see ALTER/DISPLAY console operation 

see also dumps 
Usage 4.96 

by DOS/VS 4.96 

by job accounting 4.97 

by POWER 4.97 

byPOWER/RJE 4.97 

for programmer use 4.96, 4.98 

for sub-routine linkage 4.96 
General register alter trace 2.82 

when to use 2.82 
Generating a stand-alone dump program 2.15 
Generation option table A.50 
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G (continued) 

GSVC trace 2.48 

examples of output 2.50 

format and contents of a trace entry 2.48 

tracing options 2.47 

when to use 2.47 



H 

Hand son debugging 1 . 4 

see also flowcharts, for the operator 
Hard wait 1.10 
causes 1.11 
during IPL 2.177 

isolation of cause (programmers flowchart) 4.7, 4.8 
messages, list of 2.161, 3.2, 4.6 
operators flowchart 3.14 
Hardware error recording and recovery 1 .21 , 2.1 88 

pictorial representation of 1.22, 2.188 
Hardware Instruction Retry (HIR) 2.197 

Hints for debugging, see debugging hints 
HIST, option of EREP 2.214 
History tapes 2.216 
creating 2.216 
for EREP 2.216 
HISTORY /RDE 2.216 
TES (Tape error statistics) 2.216 
How to copy SYSVIS (the page data set) on disk or tape 2.126 

see also SYSVIS dump 
How to locate 

AB option table 4.102 
Boundary box 4. 1 1 5 

example of A. 14 
CCB 4.78 

example of 4.78 
CCB copy block, example of A. 15, A.23 
CCW copy block, example of A. 15, A.23 
CCW/Translation control block 4.127 
Channel bucket 4.58 

example of A. 14 
Channel control table 4.58 
Channel program (CCW) 4.81 

example of 4.78 
CHANQ 4.56 

example of A. 14 
CPU 10, example of 2.95, A.12 
Error recovery block, error block 4.60 

example of A. 14 
ERRQ 4.60 

example of A. 14 
FAVP 4.54 

example of A. 13 
FICL 4.56 

example of A. 13 
FLPTR 4.56 

example of A.12 
FOCL 4.48 

example of A. 13 
Idal block, example of A.15 

example of A.15 
IT option request table 4. 1 1 
IT option table 4.100 
JIB 4.54 

example of A. 13 
Job accounting interface common table A.33 
Job accounting interface partition table A. 32 
Label save area, illustration of 4.107 
LUB 4.56 

example of A. 13 
NICL 4.54 

example of A. 13 
OC option table 4.105 



INDEX 



How to locate (continued) 
Page frame table 4.114 

exampleof 4.119, A.15 
Page table 4.113 

example of 4.119, A.15 
Partition communication regions 

example of 4. 34, A. 1 3 
Partition save area 4.106 

example of 4.106 
PC option table 4.104 
PDarea 2.56 

exampleof 2.44, A. 14 
PD standard preface table A. 14 

exampleof A. 14 
PHO option table 4.103 
PIB 4.88 

exampleof A.13 
PIB2 4.92 



4.54 



example of 
PUB 4.47 

example of 
PUBOWNER 
SDarea 2.80 
Segment table 

example of 



4.34, A.13 

A.13 
4.53 



4.112 

4.119, A.15 
System communication region (SYSCOM) 4.42 

exampleof 2.160, A.12 
System save areas 4. 1 1 
How to use 

ALTER command 2.6 
ALTER/DISPLAY console operation 

Models 135/145/155-11 2.128 

Models 115/125 2.134 

Model 158 2.145 
DSPLY command 2.8 
DUMP command 2.10 
DUMP macro 2.34,2.35 
EREP 2.192-2.210 
ESERV 2.116 
ESTVUT 2.204 
EVA 2.187 
Control registers, see program event recording 

function of A.6 

see also SDAID parameters changes 
Instruction step 

Models 135/145/155-11 2.139 

Models 115/125 2.141 

Model 158 2.151 
IPL reason information 2.189 
JDUMP macro 2.34,2.35 
LIOCS 4.65 

MAP command 2.151,2.154 
Models 115/125 dump operation 2.147 
Models 115/125 maintenance log analysis 
Model 158 display frame 2.232 
Option dump, see also system dump 2.12 
Output from the 

DSERV program 2.114 

Library display programs 2.115 

LSERV program 2.102,2.210 

LVTOC program 2.121 

SYSVIS dump program 2.157 

PDAID 2.58,2.62,2.63 

PDAID output, see examples 

PDUMP macro 2.33 

PIK A.3 
PIOCS 4.64 

example of 4.64 
Relocation factor, example of using 2.13, 2.100 
ROD command 2.188 
SDAID 2.86,2.88,2.89 
SDAID output, see examples 
Section 2 of this manual 2.2 
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INDEX H (continued) 

How to use (continued) 

Section 3 of this manual 3.1 
Section 4 of this manual 4.1 
SEREP 2.227 

Models 135/145/155-11 2.226 

Model 158 2.228 
Serviceability aids for POWER/POWER RJE A.35-A.37 
SHOWCB macro 4.73 
Stop on address compare 2.143 

Models 135/145/155-11 2.143 

Models 115/125 2.154 

Model 158 2.159 
SYSLOGID A.3 
System dump 2.13,2.14 
TESTCB macro 4.73 
The linkage editor map 2.13, 2.166 
The stand-alone dump output 2.22, A. 11 
TheTIK A.4 
This manual vii 
Transient dump program 2.25, 2.26 

I 

ID AL block 4.122 
Imperative macros 

forLIOCS 4.65 

forVSAM 4.72,4.73 
Index, visual, of debugging aids 2.3 
Index frame (Model 158) 1.26,2.228 
Incorrect output 

causes 1.13 

definition 1.13 

isolation of cause, programmers flowchart 4.12 

operator action 1.13 

operator flowchart 3.26 

recognizing 1.13 
Indicators for loops and wait states 1.12 
Individual recording 2.201, 2.205 
Information blocks, see supervisor information blocks 
Information recorded on SYSREC, see SYSREC record types 
Initializing output (SDAID) 2.95 
Initializing SDAID flowchart 2.89 
Initial checks for the programmer 4.3 
Initial examination of 

job control language and device assignments 3.15 

job set up, job preparation 3.13 

program preparation 4.3 

stand-alone dump output 2.22 
example of A.11-A.30 
Initial system checks for the operator 3.15 
Instruction stepping, see tracing a loop 

see also SDAID instruction trace 
I/O error during FETCH 2.180 
I/O device malfunctions 1.16 

examples of 1.16 

operator action 1.16 
I/O device type codes 4.50-4.52 
Input /output system, see IOCS 
Instruction trace 2.82 

when to use 2.82 
Intermittent errors 1.14 

definition 1.14 

hardware failures 1.14 

programming errors 1.14 

recording, see RMS 
Interrelationships between 

imperative, declarative and MOD macros 4.69, 4.70 

LIOCS and PIOCS, illustration of 4.63 

original channel program and the copy blocks 4.1 23 

page management tables, illustration of 4.117 

supervisor I/O tables and blocks 4.45 

VSAM control blocks, illustration of 4.74 
Interrupt status information 4.109 



interpreting output from 

a dump containing a CCB 4.78 

a stand-alone dump A.11-A.30 

a system dump 2.14,2.14 

DSERV 2.114 

EREP 2.224 

LSERV 2.110 

LVTOC 2.121,2.122 

PDAID 2.44,2.47,2.50,2.53 

SDAID 2.95,2.100 

The Linkage Editor Map 2.13 

The Linkage Editor diagnostic of input 2.182, 2.1 83 

The MAP command 2.169 

Transient dump 2.31 
IOCS (input/output control system) 4.62-4.76 

see also Logical IOCS 

see also Physical IOCS 

see also Virtual Storage Access Method (VSAM) 
I/O tables 

Access Method Control Block (ACB) 4.76 

CCB copy block 4.122 

CCW copy block 4.126 

CCW Translation Control Block 4.127 

Channel bucket 4.58 

Channel control table 4.58 

Channel queue (CHANQ) 4.56 

Error recovery block 4.60 

Error Queue (ERRQ) 4.60 

Exit List Block (EXLST) 4.74 

Idal block 4.122 

Job Information Block (JIB) 4.54 

Line Mode Table (MT) A. 10 

Logical Unit Block (LUB) 4.46 

Physical Unit Block (PUB) 4.48 

PUBOWNERSHIP 4.53 

Request Parameter List (RPL) 4.75 
I/O Requestors Partition or System Task ID (REQID) A.5 
I/O Requestors Task Identification (TKREQID) A.5 
I/O Trace 2.42 

examples of output 2.44 

format and contents of a trace entry 2.42 

tracing options 2.43 

when to use 2.43 
IPL/EOD recording 2.203 
IPL error messages 2.177 
IPL errors 2.177 

operators action (flowchart) 3.3 

programmer action (flowchart) 4.5 
IPL reason information codes 2.204 
Isolating errors recognized as 

a hard wait state 4.7, 4.8 

a loop 4.11 

a program check in supervisor 4.25 

a program check in SVA 4.23 

a program check in user program 4.19 

a soft wait state 4.9,4.10 

an error during IPL 4.5 

illegal SVC 4.25 

incorrect output 4. 1 2-4. 1 7 

other reasons 4.26 
IT option request table 4.101 
IT option table 4.100 
Interrelationship between DTF and MOD macros 4.69 



JDUMP macro 2.34 
format of 2.34 
information dumped 2.34 
when to use 2.35 
general description A. 31 
partition table A.3 2 
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J (continued) 

JDUMP macro (continued) 

programming considerations A.34 
Job accounting interface A.32 

common table A.33 
Job control commands and statements 

see commands 

see also statements 
Job Information Block (JIB) 4.54 

examination of 4.54 

explanation of the contents of 4.55 

format of 4.55 

how to locate 4.54 
Job stream examples 

copying SYSVIS to SYS001 2.126 

dumping SYS001 (SYSVIS copy) to SYSLST 2.1 27 

dumping SYSVIS to SYSLST 2.128 

executing CSERV 2.112 

executing DSERV 2.113 

executing DUMPGEN 2.17 

executing EREP 2.110, 2.113 

executing ESTVUT 2.209 

executing ESERV A.8 

executing LSERV 2.102 

executing LVTOC 2.120 

executing PDAID 

viaSYSIPT 2.68,2.69 
viaSYSLOG 2.70,2.73 

executing PSERV 2.113 

executing RSERV 2.112 

executing SSERV 2.113 

executing SUM option of EREP A.80 

initializing SDAID 2.96 

initializing the transient dump 

process tape error statistics A. 78 
Job stream trace, example of 2.167 



Label information cylinder 2.103 

format and contents 2.103 
for DASD labels 2.107 
for Tape labels 2.106 

function 2.103 

location, on SYSRES 2.104 

track allocation 2.105 
Label information display program (LSERV) 2.102 

example of output 2.108, 2.109, 2.110 

executing 2.102 

system requirements 2.102 

summary of information provided 2.102 

when and how to use 2.102 
Label save areas 4.106,4.107 
Layout of SYSRES 2.104 
Library display programs 2.111 

example of a DSERV output 2.1 14 

example of a RSERV output 2.115 

table of control cards 2.112, 2.113 

when and how to use 2.1 1 1 
LIK A.5 
Linkage editor 2.181 

diagnostic of input 2.182 

error flags 2.182,2.183 

map 2.181 

summary 2.185 
Linkage registers 4.98 
List of flowcharts xi 
List of illustrations xi 
List of Program Interrupt codes 4.109 
List of tables xi 

List of WAIT STATE codes 2.176, 3.3, 3.4, 4.6 
Locating information blocks and save areas, see how to locate 
Locating partition communication regions 4.34 



INDEX 



Locating the POWER partition 

Log analysis displays (Model 115/125) 1.25, 2.230 

Logical IOCS 4.62 

using 4.65 
Logical transietn area 2. 1 95 

dumping, see transient dump 
Logical transient owner identification key (LIK) A.5 
Logical transient key (LTK) A.5 
Logical unit block (LUB) 4.56 

explanation of the contents of 4.47 

format of 4.47 

how to locate 4.46 
Loop tracing 1.20 

instruction step method 2.146 
Models 135/145/155-11 2.147 
Models 115/125 2.149 
Model 158 2.151 

using the SDAID BR and or IF trace, example of 2.100 
Loops, see unintended program loop 
Low address storage 1.18, 2.171 

contents of 2.174 

displaying 2.171 

example of, in a system dump output 2.175 

format of 2.175 

illustration of 1.18 

in a stand-alone dump output 

when to display 2.171 
LTK A.5 



M 

Machine Check Analysis and Recovery (MCAR) 2.196 

general flow of processing (illustration of) 2.192 
after hard machine check interrupt 2.192 
after soft machine check interrupt 2.192 

modes of operation 2.196 
Main storage alter trace 2.82 

when to use 2.82 
Maintenance program selection (Model 115/125) 1.25, 2.230 
Making a back up copy of SYSVIS (PDS), see SYSVIS dump 
Malfunction 

definition 1 .6 

during program testing 1.6 

during single partition operation 1.6 

in a multiprogramming environment 1.6 

using teleprocessing 1.6 
Manual frame (Model 158) 2.150 
MAP command 2.169 

example of 2.167, 2.169 
Map, linkage editor 2.181 

example of 2.181 
Matching PUB2 space 2.203 
Message 0S041 list of causes 4.24 
Message X'07E6' 2.167 
Messages, during SDAID initialization 2.88 

example of 2.96 

to initiate PDAID routines 2.62 
Methods of output 

for PDAID, see PDAID trace routines 

for SDAID, see SDAID trace routines 
Miscellaneous Data Recorder (MDR) 2.200 
MOD macros 4.68 
Model 115/125 display, examples of 

Address Compare 2.147 

ALTER/DISPLAY control registers 2.143 

ALTER/DISPLAY floating point registers 2. 1 42 

ALTER/DISPLAY general registers 2.142 

ALTER/DISPLAY main (real) storage 2.143 

ALTER/DISPLAY protection key 2.143 

ALTER/DISPLAY PSW 2.142 

ALTER/DISPLAY selection 2.139 

ALTER/DISPLAY virtual storage 2.143 
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Model 115/125 display, examples of (continued) 

Instruction Step 2.146 

Main(real) storage dump (Model 115/125 only) 2.160 

Maintenance program selection 1.25, 2.231 

Mode selection 2.139 
Model 115/125 maintenance log analysis 2.230 
Model 158 frames, examples of 

ALTER/DISPLAY frame 2.144 

INDEX FRAME 1.26, 2.228 

MANUAL FRAME 2.150, 2.158 

SEREP FRAME 2.229 
Modes of output, for PDAID 2.40 
Module 4.68 

prefixes for IBM supplied modules 4.68 
Monitor call instruction A.9 
MVCOM macro 4.34 

N 

NICL 4.46 

how to locate 4.46 
Non-critical area 2.18 

locating 2.18 
Non-destroying dump 2.84 

discontinuing (stopping) before completion 2.84 

how to obtain 2.84 

when to use 2.84 
Non-translating dump, example of 2.25 

o 

OC option table 4.105 

Offline debugging, program debugging 1.27, 4.2 

Online Test Executive Program (OLTEP) 2.234 

description and operation 2.235 

features of 2.234 

illustration of 2.234 

uses of 2.234 
Operators video console display unit 1.25 

see also Models 115/125 displays 

see also Model 158 
Operator commands for RMS 2.203 

illustration of 2.189 

Matching PUB 2 space 2.203 

MODE 2.205 

ROD 2.203 
Operators flowcharts, for gathering information 3.3-3.25 

see also flowcharts, for the operator 
Options for CLEAR EREP 2.210 

EDIT 2.210 

HIST 2.214 

List of 2.209 

RDESUM 2.213 

SELECT 2.212 

SUM 2.211 

TES 2.215 
Organization of partition, and label save areas 4.1 07 
Organization of SYSRES 2.104 
Organization of the supervisor, illustration of 4.33 
Output modes (devices) for PDAID 2.40 
Output information 

for PDAID 2.42, 2.45, 2.48, 2.50 

for SDAID 2.78, 2.79, 2.80 



Page frame table 4.114 

example of (in a dump output) 4.119, A.15 

format and contents 4.114 

how to locate 4.114 
Page frame table extension 4.114 

how to locate 4.114 



Page management tables 4. 1 1 2-4.1 19 
boundary box 4.115 

example of dumping using SDAID output class 05 2.97 
example of interpreting in a dump output 4.119, A.15 
interrelationship, illustration of 4.1 17 
Page frame table 4.1 14 
Page frame table extension 4.114 
Page table 4.112 
segment table 4.112 
Page tracing routines 2.8 1 
example of 2.99 
when to use 2.81 
Page Table 4.112 

example of (in a dump output) 4.119, A.15 
explanation of the contents of 4.113 
format of 4.113 
how to locate 4.113 
initialization 4.112 
Page Enqueue Trace 2.76 
Page Handling Trace 2.76 
Page Translation Exception Trace 2.76 
Parameters 

for PDAID 2.62 
for SDAID 2.88 

for the MODE command 2.205,2.206 
for the Models 1 15/125 RMS, RMSR support 2.1 88 
for the Transient Dump 2.28 
Partition communication regions (COMREGs) 4.34 

how to locate, example of 4.34 
Partition Identification, see PIK 
Partition save area 4.106 

how to locate, example of 4.106 
PC option table 4.104 
PD address table A. 2 

how to locate, see PD area 
PD area 2.56 
dumping 2.56 
format and contents of 2.57 
locating 2.56 
PDAID and SDAID used together (concurrently) 2.40 
PDAID output, see examples 
PDAID trace routines 2.39 
caution before using 2.39 

description and operation of the trace routines 2.42 
dumping the PD area 2.56 
dumping the PDAID alternate area 2.60 
dumping the tape used for PDAID output (PDLIST) 2.41 
error messages 2.61 
F/L trace 2.45 

examples of output 2.47 
format and contents of a trace entry 2.45 
modes and output 2.46 
tracing options 2.46 
when to use 2.46 
General description 2.39 
GSVC trace 2.48 

examples of output 2.50 
format and contents of a trace entry 2.48 
modes of output 2.49 
tracing options 2.49 
when to use 2.49 
Job stream entry examples 
viaSYSIPT 2.69,2.70 
viaSYSLOG 2.72,2.73 
Modes of output 2.40 

core-wrap in an alternate area 2.41 
core-wrap in the PD area 2.41 
line printer 2.40 
magnetic tape 2.40 

when to use core-wrap output mode 2.41 
Operator's flowchart for initializing 2.63 
Printing the tape used for the PDAID output (PDLIST) 2.41 
QTAM trace 2.51 
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P (continued) 

QTAM trace (continued) 
example of output 2.53 
format and contents of a trace entry 2.51 
modes of output 2.52 
tracing options 2.52 
when to use 2.52 

Restrictions 2.40 

Selecting the output device 2.59 
Specifying an alternate area 2.60 

System requirements 2.40 

Table of parameters 2.62 

Terminating 2.41 
PDAID transient dump, see Transient dump 
PDLIST 2.41 
PDUMP macro 2.32 

example of output 2.33 

format of 2.32 

information dumped 2.40 

when and how to use 2.33 
PD standard preface table A. 2 

how to locate, see PD area 
PHO option table 4.103 
Physical IOCS 4.62 

using 4.64 
Physical transient area 2.195 

dumping, see transient dump 
PIK A.3 
POWER/VS 

Problem analysis for programs running under 4.30 
Service aids for A. 3 9 

File dump program A.40 
PRINT GEN, PRINT NOGEN assembler language statement 

example of 4.70 
Printing the contents of SYSREC, see EREP 
Printing the contents of SYSVIS, see SYSVIS dump 
Printing the tape for PDAID output (PDLIST) 2.41 
Prefixes for IBM modules 4.68 
Processing tape error statistics 

using EREP 2.217 

using EST VUT 2.219 
Program check interrupt 

causes 1.15 

definition 1.15 

example of 2.12,2.13 

isolation of cause, programmers flowchart 4.30 

inSVA 2.12,2.13 

list of codes 4.109 

operation action 1.15 

operator flowchart 3.25 
Program Event Recording (PER) A. 8 
Program Information Block (PIB) 4.88-4.91 

format of 4.89-4.91 

how to locate 4.88 
Program Information Block Extension (PIB2) 4.92, 4.93 

format of 4.93 

how to locate 4.92 
Program Interrupt Key (PIK) A.3 
Programmers flowcharts 4.2 

see also flowcharts 
Programmer Unit Block (PUB) 4.48-4.52 

examination of 4.48 

explanation of the contents 4.49-4.5 2 

format of 4.48 

how to locate 4.48 
Programming considerations for the Job Accounting Option 
Program Status Word 2.173 

displaying, dumping, SDAID output class 1 (PSW) 2.74 
see also console ALTER/DISPLAY operation 

format and contents 2.173 

locating 2.175 
PUB2 2.203 



INDEX 



A.34 



PUBOWNERSHIP, PUBOWNER 
format of 4.53 
how to locate 4.53 



4.53 



Queues 

error queue 4.62 

channel queue 4.56 
Quick reference list of serviceability aids 2.3 
QTAM trace 2.51 

example of output 2.5 3 

format and contents of a trace entry 2.51 

tracing options 2.52 

when to use 2.52 

R 

R A S transient area 2.195 
RDESUM, option of EREP 2.3 

examples of A. 80 
Real storage areas destroyed by the stand-alone dump program 

example of A. 12 

see also NON-CRITICAL area 
Real storage dump, see SDAID dump routines 
Recommendations for further problem analysis 

see flowcharts for the programmer 
Recognizing a malfunction 

a loop 1.8,1.12,3.12 

a wait state 1.10,1.12,3.12 

hardware error on Model 158 1.26,2.232 

incorrect output 1.13,3.12 

job/program canceled by system 1.15, 3.12 

program check interrupt 1.15,3.12 
Recovery from a hard wait, operators flowchart 2.189, 3.14 
Recovery from a soft wait 
Recovery Management Support (RMS) 2.1 88, 2.206 

components 2.195 

detailed description 2.196 

general description 2.188 

illustration of 2.189 

operation 2,190 

system requirements 2.188 
Recovery Management Support Recorder (RMSR) 2.1 89 

see also SYSREC 
Re-entrant modules 4.68 

Register Alternation, see ALTER/DISPLAY console features 
Reliability, Availability and Serviceability (RAS) 1.21 
Reliability Data Extractor (RDE) see IPL/EOD recording 

see also IPL reason information 

see also ROD command 
Relocation factor, example of using 2.13, 2.100 

see also linkage editor map 
Restrictions, on use of 

ALTER command 2.7 

DSPLY command 2.9 

PDAID 2.40 

PDUMP macro 2.33 

SDAID 2.75 

SYSVIS dump 2.125 
RJE I/O trace A.3 9 

ROD command 2.203 



Save areas 

ABSAVEarea 4.108 

Label save area, illustration of 4.107 

partition and label save area 4.106 

how to locate 4.106 
save areas for job accounting 4.1 11 
system save areas 4.110 
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Save areas (continued) 

user exit routine save areas, illustration of 4.109 
save usage command 2.164 
SDarea 2.85 

SDAID and PDAID used together (concurrently) 2.77 
SDAID initializing output, example of 2.95 
SDAID output, see examples 

SDAID output classes, table of, for the elementary events 2.79 
Output class COMREG, (04) 2.79 

Output class DUMPREAL (Non-destroying dump) (07) 2.79 
Output class FASTREC, (00) 2.79 
Output class GPR, (02) 2.79 
Output class LOCORE, (03) 2.79 
Output class PAGETAB, (05) 2.79 
Output class PDUMP, (08) 2.79 
Output class PSW (01) 2.79 
Output class SUPVISOR, (06) 2.79 
SDAID trace routines 2.73 

altering SDAID parameters after initialization 2.87 

a note to programmers 2.87 

caution before using 2.74 

characteristics 2.76 

description and operation of the routines 2.81 

dump on program check 2.85 

when to use 2.85 
examples of output 

output class COMREG 2.98 

output class FASTREC 2.99 

output class FASTREC, AUTOMATIC 2.98 

output class PAGETAB 2.97 

output class PSW (during BR, IF and GA trace) 2.100 

predefined output 2.99 
General description 2.73 
General register alter trace (GA) 2.82 
Initializing 2.86 

example of 2.96 

flowchart 1.89 
Initializing output 2.95 
Instruction trace (IF) 2.82 
Job entry example 2.96 
Messages during Initializing 2.88 

example of 2.96 
Non-destroying dump 2.84 

how to obtain 2.84 

when to use 2.84 
Operators flowchart for initializing 2.84 
Output information 2.78 / 

Page tracing routines 2.81 
Parameters for initializing SDAID 2.88 
PDUMP output class 2.78 
SDAID events 2.77 

SDAID output classes, output information 2.78 
Specifying the area to be traced 2.80 
Stop and dump facilities 2.75 
Stop and dump routines 2.83 
Stop on address 2.83 
Storage alter trace (SA) 2.82 
Successful branch trace (BR) 2.82 
System requirements 2.75 

Table of output class options for elementary events 2.79 
Table of predefined output for dedicated events 2.80 
Terminating 2.77 
The SDarea 2.85 

Using PDAID and SDAID together 2.77 
Segment table 4.112 

example of (in a dump output) 4.119, A.15 
format and contents 4.1 13 
how to locate 4.112 

interrelationship to page table, illustration of 4.1 17 
SELECT, option of EREP 2.212 
SEREP 1.24,2.226 

Models 135/145/155-11 2.226 



\ 



SEREP (continued) 

Model 158 2.228 
Serviceability aids 1.3 
resume 1.3 

pictorial representation of 1 .5 

provided by the operators console 2.1 31 

visual index 2.3 

see dumps 

see also trace routines 

see also hardware error recording 
Serviceability aids from the operators console 

ALTER/DISPLAY console operation 2.1 32 

clear real storage 2.163 

instruction stepping 2.146 

Models 115/125 console dump operation 2.160 

Stop on address compare 2.152 
SHOWCB macro 4.73 
Snap shot dump 

PDUMP macro 2.32 

SDAID PDUMP output class 2.78 
Soft wait 1.10 

causes 1.11 

isolation of cause, programmers flowchart 4.10 

operators action, flowchart 3.14 

recovery from 1.11 
Software routines used by RMS 2. 180 
Specifying the area to be traced by SDAID 2.80 
Statements, job control 

LIST 2.170 

LISTIO 2.166,2.167,2.168 

LOG 2.170 

NODUMP 2.170 

NOLIST 2.170 

NOLOG 2.170 

//LISTIO 2.177-2.168 

//OPTION DUMP, see also system dump 2.170 

//PAUSE 2.170 

example of 2.167 
Stand-alone dump 2.18 

a note to operators 2.22 

a note to programmers 2.22 

example of A.11-A.30 

generating, see DUMPGEN 

how to use the output 2.22 

information dumped 2.18, 2.19 

pictorial representation of 2.20, 2.21 

operation 2.18 

operators flowchart 2.23 

when to use 2.19 
Stand-alone EREP, see SEREP 

Standard dump, non-translating dump, example of 2.31 
Status, see MODE command, parameters of 2.206 
Sto p and dum p routines 2.83 

when to use 2.83 
Stop on address (SDAID) 2.83 

see also stop on address compare 
Stop on address compare (all Models) 2.152 

Models 135/145/155-11 2.152,2.153 

Models 115/125 2.156 

Model 158 2.158 

when to use 2.156 

see also data compare trap 
Stop on event (SDAID) 2.75 
Stopping the SDAID non-destroying dump 2.84 
Storage alternation 

using the ALTER command 2.6 

using the ALTER/DISPLAY console feature 2.1 32 
Storage areas destroyed by the stand-alone dump program 2.22 

example of A. 12 

see also non-critical area 
Storage dumps, pictorial representation of 1.19 

see also dumps 
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Store status 2.162 

Sub-system ID, see IPL reason information 

Successful branch trace 2.82 

example of output 2.100 

when to use 2.82 
Supervisor call trace, see GSVC trace 
Supervisor calls 4.84 

function 4.84 

list of 4.85-4.87 
Supervisor communication macros 2.32 

JDUMP macro 2.34 

PDUMP macro 2.32 

DUMP macro 2.34 
Supervisor information blocks 

PIB 4.88 

PIB extension (PIB2) 4.88 

see also page management tables 

see also supervisor I/O tables 
Supervisor I/O tables 

CCB copy block 4.122 

CCW copy block 4.126 

CCW/TCB 4.128 

Channel Bucket 4.58 

Channel Control Table 4.58 

Channel Queue 4.56 

Error Recovery Block, Error Block 4.60 

Error Queue 4.60 

FAVP 4.54 

FICL 4.46 

Fix information block 4.128 

FLPTR 4.56 

FOCI 4.48 

ID AL block 4.122 

Interrelationship illustration of 4.45 

JIB 4.56 

LMT A. 10 

LUB 4.46 

NICE 4.46 

PUB 4.48 

PUBOWNERSHIP 4.50 
Supervisor, organization of 4.33 
Supervisor tables, see supervisor I/O tables 
Summary of error checking for VSAM imperative macros 4.73 
SVC trace, see GSVC trace 
SYSLOGID a.3 
SYSREC 2.199 

creating 2.199 

record types 2.199 

counter overflow record 2.200 
forCCH 2.199 
forMCAR 2.199 

IPL/EOD 2.200 

MDR 2.200 

RDE 2.200 

Tape volume dismount record 2.200 

Unit check record 2.200 

Relationship 

between SYSREC record types and EREP 2.194 
SYSRES extent, format and contents 2.104 
System communication region (SYSCOM) 4.42 

format of 4.42,4.43 

how to locate 4.42 
System dump 2.12 

example of 2.13, 2.14 

how to interpret, example of 2.13, 2.14 

when to use 2.12 
System information required 

to isolate the cause of malfunctions 4.2 
System recorder file, see SYSREC 
System requirements for 

EREP 2.207 

EVA 2.202 



LSERV 2.102 

PDAID 2.40 

SDAID 2.75 

RMS 2.188 

TES 2.201 

Transient dump 2.25 
System save areas 4.110 
System status information, example of 2.184 
SYSVISdump 2.125 

description and operation 2.125 

error messages 2.129 
examples of 2.129 

how to execute 2.126 

example job streams 2.125, 2.127, 2.128 

how to use the dump output 2.130 

operators flowchart 2.24 

restriction 2.125 

terminating 2.129 

when to execute 2.130 



Tables, list of, xi 
Table of contents for 

Appendixes A.l 

Section 1 1.1 

Section 2-A 2.5 

Section 2-B 2.37 

Section 2-C 2.101 

Section 2-D 2.131 

Section 2-E 2.165 

Section 2-F 2.187 

Section 3 3.1 

Section 4, Part 1 4.1 

Section 4, Part 2 4.32 

This manual (overall contents) iv 
Task Interrupt Key (TIK) A.3 
Tape Error Statistics (TES) 2.201 

for magnetic tape volumes 2.201 

options for 2.208 

system requirements 2.201 
Terminating 

PDAID 2.41 

PDAID core-wrap in alternate area 2.41 

SDAID 2.77 

The transient dump 2.27 

SYSVISdump 2.129 
TES, option of EREP 2.215 
TESTCB macro 4.73 
Threshold values for EFL 2.196 
Trace routines 2.39 

PDAID 2.39 

SDAID 2.73 
Tracing a loop 

instruction step method 

for the Models 135/145/155-11 2.147 
for the Models 115/125 2.149 

using the SDAID BR/IF TRACE, example of 2.100 
Transient areas (illustration of) 2.195 
Transient dump 2.23 

example of output 2.3 1 

information dumped 2.25 

initializing 2.26 

job stream example 2.30 

operators flowchart 2.29 

selecting the output device 2.27 

system requirements (as for PDAID) 2.40 

table of operands 2.28 

terminating 2.27 

when to use 2.27 
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Transient routines (A, B and R transients) 2.195 
Translating addresses, see converting addresses 
Translating dump, example of 2.1 1 , 2.1 2, A.l 1-A.30 
Translation exception trace, see page tracing routines 
Types of malfunctions 

incorrect output 1.13 

intermittent errors 1.14 

I/O device malfunctions 1.16 

loops 1.8 

program check interrupt 1.15 

wait status 1.10 



u 

Unintended program loop 

causes 1.8 

definition 1.8 

isolation of cause, programmers flowchart 4.1 1 

operator action 1 .9 

operator flowchart 3.20 

recognizing 1.8 

types of 1.8 
Unrecoverable I/O error during FETCH 
User exit routine save areas 4.108 

illustration of 4.109 
User exit routine support, tables used by 4.99-4.105 

Abnormal Termination (AB) 4.102 

Internal Timer option (IT) 4.100, 4.101 

Operator Communication (OC) 4.105 

Page Fault Handling Overlap (PHO) 4.103 

Program Check (PC) 4.104 
Using LIOCS 4.65 

Using PDAID and SDAID concurrently 2.40 
Using PIOCS 4.64 
Using SDAID and PDAID concurrently 2.77 



Video display unit Models 115/125 

example of displays, see Models 115/125 displays 
Virtual storage, organization of 4.33 
Virtual Storage Access Method (VSAM) 4.72 

access method control block 4.76 

declarative macros 4.72 

error detection using VSAM macros 4.73 

exit list 4.74 

imperative macros 4.72 

relationship of control blocks 4.74 

Request Parameter List (RPL) 4.75 

RPL debugging hints 4.72 

SHOWCB and TESTCB macros 4.73 

summary of error checking for VSAM imperative macros 
Visual Display Unit, see Models 115/125 displays 

see also Model 158 frames 
Volume Table of Contents (VTOC) 2.118 

contents of 2.118 

function of 2.118,2.119 
Volume Table of Contents display program (LVTOC) 2.1 1 8 

example 2.121 

executing 2.120 



4.73 



W 

Wait states 

causes of a soft wait 1.11 

coded messages, list of 2.176 

definition 1.10 

due to a hardware failure 2.180 

during IPL 2.177 

during program operation 2.178 

isolation of cause, programmers flowchart 4.7 

location of 2.176 

operator action 1.11 

operators flowchart 3.16 

recognizing 1.10 

types of 1.10 
Wait macro, example of 4.64 
Wait state messages 2.176 

during IPL 2.177 

during program execution 2.178 

list of 2.176,3.3,3.4 
When to use 

ALTER/DISPLAY console operation 2.132 

Error volume analysis 2.202 

General Register Alter Trace 2.82 

Instruction step console operation 2.146 

LISTIO and //LISTIO 2.166 

Model 125 console dump operation 2.160 

Model 125 save usage counters 2.162 

PDAID core-wrap output mode 2.41 

PDAID F/L trace 2.46 

PDAID GSVC trace 2.49 

PDAID I/O trace 2.43 

SDAID dump on program check 2.85 

SDAID instruction trace 2.82 

SDAID main storage alter trace 2.82 

SDAID non-destroying dump 2.84 

SDAID page tracing routines 2.81 

SDAID stop on address 2.83 

SDAID stop on event 2.83 

SDAID successful branch trace 2.82 

SEREP 2.111 

Stop on address compare console operation 2.152 

Store status function 2.162 

The ALTER command 2.7 

The DSPLY command 2.9 

The D UMP command 2.11 

The DUMP macro 2.35 

The ESERV program 2.117 

The JDUMP macro 2.35 

The Library Display Programs 2.111,2.115 

The LSERV program 2. 102 

The LVTOC program 2.120 

The MAP command 2.166 

The PDAID transient dump 2.27 

The PDUMP transient dump 2.27 

The ROD command 2.204 

The Stand-alone dump 2.19 

The System dump 2.12 

The SYS VIS dump 2.130 

The // OPTION DUMP statement 2.12 

Wrap- Around tracing 2.80 

see also PDAID core-wrap output 



